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:
parent
69e9017730
commit
3628b6d434
225 changed files with 22675 additions and 11631 deletions
|
@ -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">}}
|
||||
|
|
|
@ -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用户:
|
||||
|
||||
|
|
|
@ -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存储,你可以跳过此步)。
|
||||
|
|
|
@ -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是单个进程,具有可配置的线程数。
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
||||
|
|
|
@ -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`用户:
|
||||
|
||||
|
|
|
@ -13,7 +13,7 @@ menu:
|
|||
|
||||
为了让你发现潜在的有趣内容,Mastodon提供了一种浏览所有公共嘟文的方法。当然,所有Mastodon服务器之间并不会全局共享嘟文,因此无法同时浏览*所有*公共嘟文。当你浏览**跨站公共时间轴**时,你将看到你所在的服务器所知道的所有公共嘟文。你的服务器可以通过多种方式发现嘟文,但其中大部分是来自你服务器上的其他用户关注的人。
|
||||
|
||||
这里有一种方法筛选跨站时间轴,以仅查看由你所在服务器发出的公共嘟文:**本站时间轴**。请注意这里的本地\(local\)仅是指服务器,而不是地理位置。
|
||||
这里有一种方法筛选跨站时间轴,以仅查看由你所在服务器发出的公共嘟文:**本站时间轴**。请注意这里的本地(local)仅是指服务器,而不是地理位置。
|
||||
|
||||
## 与其他人的嘟文互动 {#actions}
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
|
|
@ -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">}}
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue