Update content for 4.0 (part 1) (#991)

* add rules

* join date on profiles

* deprecate follow scope

* deprecate identity proofs

* familiar followers

* use definition lists instead of tables for defining activitypub properties

* reformat notifications page into markdown

* fix broken links to publicKey header

* Application website is now nullable

* update environment variables added and removed

* fix typo

* fix heading level

* min_id and max_id can be used at the same time (3.3)

* fix typo

* new tootctl options

* reformat tootctl page to use definition lists for params

* add rules and configuration to Instance

* fix typo

* refactor instance api page

* 3.3.0 duration on mutes

* 3.3.0 mute_expires_at

* improve section headings

* 3.4.0 resend email confirmation api

* 3.4.0 policy on push subscriptions

* 3.4.0 add details to account registration error

* refactor accounts api page and start adding relrefs to entity pages

* 3.4.0 accounts/lookup api

* add see also to accounts methods

* add more see-also links

* 3.5.0 appeal mod decisions

* 3.5.0 reformat reports and add category/rule_ids params

* document report entity and missing responses

* fix typos

* fix relrefs and url schema, add aliases to old urls

* add archetypes for new methods/entities

* update archetypes with see-also stubs

* clearer presentation of rate limits

* announcements api methods

* refactor apps methods

* refactor bookmarks methods + some anchors

* refactor conversations methods

* custom_emojis methods refactor

* anchors

* refactor directory methods

* refactor domain_blocks methods

* add see also to emails methods

* fix page relref shortcodes to specific methods + refactor endorsements methods

* min_id max_id

* refactor favourites methods

* refactor featured_tags methods

* refactor filters methods, make path params consistent, i18n required shortcode

* follow_requests methods

* lists methods

* markers methods

* forgot to add entity links

* media methods, also fix formatting of some json errors

* mutes methods, add more see-also links

* oembed methods

* preferences methods

* proofs methods

* push methods

* suggestions methods

* 3.5.0 add new trend types, fix formatting

* refactor streaming methods

* refactor oauth methods

* note that streaming api casts payload to string

* refactor search methods

* refactor polls methods

* remove unnecessary link

* reformat scheduled_statuses methods

* reformat timelines methods

* reformat statuses methods

* 3.5.0 editing statuses

* consistent use of array brackets in form data parameters

* update dev setup guide, add vagrant and clean up text

* add admin/accounts methods

* 3.6 role entity

* admin/accounts methods v2

* minor fix

* stub admin/reports methods

* document admin reports

* add 403 example to methods archetype

* cleanup entities for admin reports and add new attrs

* 3.6.0 domain allows methods + normalize admin entity namespace

* fix search-and-replace error

* add aliases for admin entities

* 3.6.0 canonical email blocks entity

* 3.5.0 admin/retention api

* 3.5.0 add admin::ip doc

* 3.5.0 admin/reports

* 3.6.0 admin/domain_allows

* 3.5.0 admin/dimensions

* 3.6.0 permissions and roles

* minor formatting fix

* add anchor link to headings

* checkpoint

* add update commands to dev env setup guide

* change mentions of v3.6 to v4.0

* tootctl now uses custom roles

* fix formatting

* v2 instance api

* update frontmatter, add better titles to pages

* minor wording change

* consistency

* add more aliases

* add placeholders and WIP notices

* explain link pagination and stub out todos

* switch baseURL to https

* 422 on reports with rules but category!=violation

* document bug fixes

* fix typo

* remove duplicate API method definition

* s/tootsuite/mastodon for github links

* remove unnecessary escaping

* s/tootsuite/mastodon in Entity archetype

* add missing nullable shortcode

* clarify oauth scope when requesting a user token

* api/v2/media now synchronous for images

* DISALLOW_UNAUTHENTICATED_API_ACCESS

* add undocumented env variables

* add instance domain blocks and extended description api

* add SMTP_ENABLE_STARTTLS

* add description to SMTP_ENABLE_STARTTLS

* take suggestions from open PRs

* normalize links and flavour language

* Fully document streaming API based on source code

* Add mention of MIME types

* bump to ruby 3.0.4

* clarify how to check on async media processing

* validation of replies_policy

* remove TODOs on admin account action

* EmailDomainBlocks

* IpBlocks

* Admin::DomainBlock

* remove TODOs

* following hashtags

* followed_tags

* remove reference to unused parameter

* add new oauth scopes for admin blocks and allows

* fix command signature for i18n-tasks normalize

* reformat code structure page

* document fixes for following tags (assume 4.0.3)

* Add warning about pre-4.0 hardcoded roles

* add note about case sensitivity

* remove use of 'simply' from docs

* remove reference to silencing

* add reference to IDN normalization for verified links

* add lang parameter
This commit is contained in:
trwnh 2022-11-20 00:34:38 -06:00 committed by GitHub
parent 69e9017730
commit 3628b6d434
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
225 changed files with 22675 additions and 11631 deletions

View file

@ -49,7 +49,7 @@ Mastodon使用一种标准化的、开放的协议来实现站点之间的互动
>
> -- Eugen Rochko, Jul 6 2018, [《将Mastodon关到笼子里去》](https://blog.joinmastodon.org/2018/07/cage-the-mastodon/)
> 一个中心化的社交媒体平台有一个等级结构在这个结构中平台的规则及其实施以及平台的发展方向都是由CEO决定的\[……\] 一个去中心化的网络有意放弃了对平台所有权的控制,从本质上来讲是没有平台所有者的。
> 一个中心化的社交媒体平台有一个等级结构在这个结构中平台的规则及其实施以及平台的发展方向都是由CEO决定的[……] 一个去中心化的网络有意放弃了对平台所有权的控制,从本质上来讲是没有平台所有者的。
>
> -- Eugen Rochko, Dec 30 2018, [《为什么去中心化很重要?》](https://blog.joinmastodon.org/2018/12/why-does-decentralization-matter/)
@ -89,18 +89,18 @@ Mastodon的开发同样是通过[Patreon](https://patreon.com/mastodon)和[OpenC
学习如何使用Mastodon
{{< page-ref page="user/signup.md" >}}
{{< page-ref page="user/signup" >}}
学习如何安装Mastodon
{{< page-ref page="admin/prerequisites.md" >}}
{{< page-ref page="admin/prerequisites" >}}
学习如何为Mastodon编写应用程序
{{< page-ref page="client/intro.md" >}}
{{< page-ref page="client/intro" >}}
了解Mastodon后端以及如何向Mastodon项目做贡献
{{< page-ref page="dev/overview.md" >}}
{{< page-ref page="dev/overview" >}}
{{< translation-status-zh-cn raw_title="What is Mastodon?" raw_link="/" last_tranlation_time="2020-05-02" raw_commit="ad1ef20f171c9f61439f32168987b0b4f9abd74b">}}

View file

@ -129,7 +129,7 @@ su - mastodon
使用git下载最新稳定版Mastodon
```bash
git clone https://github.com/tootsuite/mastodon.git live && cd live
git clone https://github.com/mastodon/mastodon.git live && cd live
git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1)
```
@ -162,7 +162,7 @@ RAILS_ENV=production bundle exec rake mastodon:setup
* 预编译静态文件
* 创建数据库schema
配置文件被保存在`.env.production`。如果你愿意的话,你可以查看并编辑这个文件。请参阅[配置文件的文档]({{< relref "config.md" >}})。
配置文件被保存在`.env.production`。如果你愿意的话,你可以查看并编辑这个文件。请参阅[配置文件的文档]({{< relref "config" >}})。
你已经完成需使用mastodon用户进行的操作请切换回root用户

View file

@ -15,7 +15,7 @@ menu:
## 基本步骤 {#basic-steps}
1. 依照[产品指南]({{< relref "install.md" >}})安装新的Mastodon服务器切记不要运行 `mastodon:setup`)。
1. 依照[产品指南]({{< relref "install" >}})安装新的Mastodon服务器切记不要运行 `mastodon:setup`)。
2. 停止旧服务器上的Mastodon`systemctl stop 'mastodon-*.service'`)。
3. 依照如下指示导出并导入Postgres数据库。
4. 依照如下指示,复制 `system/` 目录下文件。注意如果你使用S3存储你可以跳过此步

View file

@ -11,11 +11,11 @@ menu:
Mastodon有三种进程
* Web \(Puma\)
* Web (Puma)
* Streaming API
* 后台进程 \(Sidekiq\)
* 后台进程 (Sidekiq)
### Web \(Puma\) {#web}
### Web (Puma) {#web}
web进程处理绝大多数应用的短HTTP请求。以下环境变量可以控制它
@ -37,7 +37,7 @@ streaming API处理长HTTP连接与WebSockets连接通过这些连接用户
一个进程可以处理相当数量的连接。 如果您愿意streaming API可以托管在其他子域上例如避免nginx代理连接开销。
### 后台进程 \(Sidekiq\) {#sidekiq}
### 后台进程 (Sidekiq) {#sidekiq}
Mastodon许多任务都分配给后台进程以确保HTTP请求快速响应并防止HTTP请求中止影响到这些任务的执行。Sidekiq是单个进程具有可配置的线程数。

View file

@ -23,7 +23,7 @@ RAILS_ENV=production bin/tootctl help
## 基础命令
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/cli.rb" caption="lib/cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/cli.rb" caption="lib/cli.rb" >}}
### `tootctl self-destruct` {#self-destruct}
@ -51,7 +51,7 @@ RAILS_ENV=production bin/tootctl help
## 帐户相关命令 {#accounts}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/accounts_cli.rb" caption="lib/mastodon/accounts\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/accounts_cli.rb" caption="lib/mastodon/accounts\_cli.rb" >}}
### `tootctl accounts rotate` {#accounts-rotate}
@ -208,7 +208,7 @@ RAILS_ENV=production bin/tootctl help
## 缓存相关命令 {#cache}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/cache_cli.rb" caption="lib/mastodon/cache\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/cache_cli.rb" caption="lib/mastodon/cache\_cli.rb" >}}
### `tootctl cache clear` {#cache-clear}
@ -232,7 +232,7 @@ RAILS_ENV=production bin/tootctl help
## 域名相关命令 {#domains}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/domains_cli.rb" caption="lib/mastodon/domains\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/domains_cli.rb" caption="lib/mastodon/domains\_cli.rb" >}}
### `tootctl domains purge` {#domains-purge}
@ -269,7 +269,7 @@ RAILS_ENV=production bin/tootctl help
## Emoji相关命令 {#emoji}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/emoji_cli.rb" caption="lib/mastodon/emoji\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/emoji_cli.rb" caption="lib/mastodon/emoji\_cli.rb" >}}
### `tootctl emoji import` {#emoji-import}
@ -301,7 +301,7 @@ RAILS_ENV=production bin/tootctl help
## 时间流Feeds相关命令 {#feeds}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/feeds_cli.rb" caption="lib/mastodon/feeds\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/feeds_cli.rb" caption="lib/mastodon/feeds\_cli.rb" >}}
### `tootctl feeds build` {#feeds-build}
@ -327,7 +327,7 @@ RAILS_ENV=production bin/tootctl help
## 媒体相关命令 {#media}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/media_cli.rb" caption="lib/mastodon/media\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/media_cli.rb" caption="lib/mastodon/media\_cli.rb" >}}
### `tootctl media remove` {#media-remove}
@ -390,7 +390,7 @@ RAILS_ENV=production bin/tootctl help
## 预览卡片Preview Cards相关命令 {#preview_cards}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/preview_cards_cli.rb" caption="lib/mastodon/preview\_cards\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/preview_cards_cli.rb" caption="lib/mastodon/preview\_cards\_cli.rb" >}}
### `tootctl preview_cards remove` {#preview_cards-remove}
@ -409,7 +409,7 @@ RAILS_ENV=production bin/tootctl help
## 搜索相关命令 {#search}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/search_cli.rb" caption="lib/mastodon/search\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/search_cli.rb" caption="lib/mastodon/search\_cli.rb" >}}
### `tootctl search deploy` {#search-deploy}
@ -425,7 +425,7 @@ RAILS_ENV=production bin/tootctl help
## 站点设定相关命令 {#settings}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/settings_cli.rb" caption="lib/mastodon/settings\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/settings_cli.rb" caption="lib/mastodon/settings\_cli.rb" >}}
### `tootctl settings registrations open` {#settings-registrations-open}
@ -443,7 +443,7 @@ RAILS_ENV=production bin/tootctl help
## 嘟文相关命令 {#statuses}
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/lib/mastodon/statuses_cli.rb" caption="lib/mastodon/statuses\_cli.rb" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/lib/mastodon/statuses_cli.rb" caption="lib/mastodon/statuses\_cli.rb" >}}
### `tootctl statuses remove` {#statuses-remove}

View file

@ -7,10 +7,10 @@ menu:
---
{{< hint style="info" >}}
当一个新的Mastodon版本释出后它将出现在[GitHub releases页面](https://github.com/tootsuite/mastodon/releases)。请注意:运行来自`master`分支的未释出代码,虽然可以进行,但不推荐这样做。
当一个新的Mastodon版本释出后它将出现在[GitHub releases页面](https://github.com/mastodon/mastodon/releases)。请注意:运行来自`master`分支的未释出代码,虽然可以进行,但不推荐这样做。
{{< /hint >}}
Mastodon版本与git tags一致。在尝试升级之前请至[GitHub releases页面](https://github.com/tootsuite/mastodon/releases)查找所需版本。该页面包含了一个**更新日专**,其中描述你需要了解的所有差异,以及**特定的升级指令**。
Mastodon版本与git tags一致。在尝试升级之前请至[GitHub releases页面](https://github.com/mastodon/mastodon/releases)查找所需版本。该页面包含了一个**更新日专**,其中描述你需要了解的所有差异,以及**特定的升级指令**。
开始之前,切换至`mastodon`用户:

View file

@ -13,7 +13,7 @@ menu:
为了让你发现潜在的有趣内容Mastodon提供了一种浏览所有公共嘟文的方法。当然所有Mastodon服务器之间并不会全局共享嘟文因此无法同时浏览*所有*公共嘟文。当你浏览**跨站公共时间轴**时,你将看到你所在的服务器所知道的所有公共嘟文。你的服务器可以通过多种方式发现嘟文,但其中大部分是来自你服务器上的其他用户关注的人。
这里有一种方法筛选跨站时间轴,以仅查看由你所在服务器发出的公共嘟文:**本站时间轴**。请注意这里的本地\(local\)仅是指服务器,而不是地理位置。
这里有一种方法筛选跨站时间轴,以仅查看由你所在服务器发出的公共嘟文:**本站时间轴**。请注意这里的本地(local)仅是指服务器,而不是地理位置。
## 与其他人的嘟文互动 {#actions}

View file

@ -15,7 +15,7 @@ menu:
### 链接 {#links}
{{< figure src="/assets/image%20%287%29.png" caption="链接必须以 http\(s\):// 开头无论长度如何都将被视为23个字符" >}}
{{< figure src="/assets/image%20%287%29.png" caption="链接必须以 http(s):// 开头无论长度如何都将被视为23个字符" >}}
如果你的嘟文中有链接,它们必须以 `http://``https://` 开头。所有的链接无论实际上有多长都将被记作23个字符。因此没有使用短链接来节省字符的必要。事实上使用短链接是极其不被推荐的。
@ -47,10 +47,10 @@ menu:
点击回形针将文件附加到你的嘟文上。你可以附上以下文件:
* **图像** \(PNG, JPG, GIF\)**最大8MB**。图像将被压缩至160万像素足够一张1280x1280px的图像。最多可以附加4张图片。
* **GIF动画**GIF动画会转换成无声的mp4就像 Imgur/Gfycat \(**GIFV**\) 一样。你也可以上传无声的MP4和WebM它们将被以同样方式处理。
* **视频** \(MP4, M4V, MOV, WebM\)**最大40MB**。视频将被转换为最大比特率1300kbps最大帧率60fps的H.264 MP4。
* **音频** \(MP3, OGG, WAV, FLAC, OPUS, AAC, M4A, 3GP\)**最大40MB**。音频将使用V2 VBR大约192kbps转码成MP3。
* **图像** (PNG, JPG, GIF)**最大8MB**。图像将被压缩至160万像素足够一张1280x1280px的图像。最多可以附加4张图片。
* **GIF动画**GIF动画会转换成无声的mp4就像 Imgur/Gfycat (**GIFV**) 一样。你也可以上传无声的MP4和WebM它们将被以同样方式处理。
* **视频** (MP4, M4V, MOV, WebM)**最大40MB**。视频将被转换为最大比特率1300kbps最大帧率60fps的H.264 MP4。
* **音频** (MP3, OGG, WAV, FLAC, OPUS, AAC, M4A, 3GP)**最大40MB**。音频将使用V2 VBR大约192kbps转码成MP3。
#### 编辑媒体 {#edit}
@ -84,8 +84,8 @@ menu:
这是默认的选项。
* 任何人都可以通过访问永久链接看到你的嘟文,而不需要登录。
* 你的嘟文将出现在应用程序内的公共\(Public\)时间轴上。
* 你的关注者将在他们的主页\(Home\)上接收到这条嘟文,任何被提及的人都将在通知中接收到这条嘟文。
* 你的嘟文将出现在应用程序内的公共(Public)时间轴上。
* 你的关注者将在他们的主页(Home)上接收到这条嘟文,任何被提及的人都将在通知中接收到这条嘟文。
* 你的嘟文可以被转发到其他人的主页中。
### 不公开 {#unlisted}

View file

@ -55,6 +55,6 @@ menu:
如果你有兴趣自己安装一切,请点击这里:
{{< page-ref page="admin/prerequisites.md" >}}
{{< page-ref page="admin/prerequisites" >}}
{{< translation-status-zh-cn raw_title="Running your own server" raw_link="/user/run-your-own/" last_tranlation_time="2020-05-03" raw_commit="ad1ef20f171c9f61439f32168987b0b4f9abd74b">}}