minor formatting changes
This commit is contained in:
a
parent
d1c6bf74bb
commit
6e9256e786
|
|
@ -34,7 +34,7 @@ This guide was written with Ubuntu Server in mind; your mileage may vary for oth
|
|||
At a high level, you’ll need to copy over the following:
|
||||
|
||||
* The `~/live/public/system` directory, which contains user-uploaded images and videos (if using S3, you don’t need this)
|
||||
* The Postgres database (using [pg\_dump](https://www.postgresql.org/docs/9.1/static/backup-dump.html))
|
||||
* The Postgres database (using [pg_dump](https://www.postgresql.org/docs/9.1/static/backup-dump.html))
|
||||
* The `~/live/.env.production` file, which contains server config and secrets
|
||||
|
||||
Less crucially, you’ll probably also want to copy the following for convenience:
|
||||
|
|
@ -45,7 +45,7 @@ Less crucially, you’ll probably also want to copy the following for convenienc
|
|||
|
||||
### Dump and load Postgres {#dump-and-load-postgres}
|
||||
|
||||
Instead of running `mastodon:setup`, we’re going to create an empty Postgres database using the `template0` database (which is useful when restoring a Postgres dump, [as described in the pg\_dump documentation](https://www.postgresql.org/docs/9.1/static/backup-dump.html#BACKUP-DUMP-RESTORE)).
|
||||
Instead of running `mastodon:setup`, we’re going to create an empty Postgres database using the `template0` database (which is useful when restoring a Postgres dump, [as described in the pg_dump documentation](https://www.postgresql.org/docs/9.1/static/backup-dump.html#BACKUP-DUMP-RESTORE)).
|
||||
|
||||
Run this as the `mastodon` user on your old system:
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ menu:
|
|||
parent: admin-optional
|
||||
---
|
||||
|
||||
Mastodon can be served through Tor as an onion service. This will give you a \*.onion address that can only be used while connected to the Tor network.
|
||||
Mastodon can be served through Tor as an onion service. This will give you a `*.onion` address that can only be used while connected to the Tor network.
|
||||
|
||||
## Installing Tor {#install}
|
||||
|
||||
|
|
|
|||
|
|
@ -279,7 +279,7 @@ production:
|
|||
url: postgresql://db_user:db_password@db_host:db_port/db_name
|
||||
```
|
||||
|
||||
Make sure the URLs point to wherever your PostgreSQL servers are. You can add multiple replicas. You could have a locally installed pgBouncer with configuration to connect to two different servers based on database name, e.g. “mastodon” going to master, “mastodon\_replica” going to the replica, so in the file above both URLs would point to the local pgBouncer with the same user, password, host and port, but different database name. There are many possibilities how this could be setup! For more information on Makara, [see their documentation](https://github.com/taskrabbit/makara#databaseyml).
|
||||
Make sure the URLs point to wherever your PostgreSQL servers are. You can add multiple replicas. You could have a locally installed pgBouncer with configuration to connect to two different servers based on database name, e.g. “mastodon” going to master, “mastodon_replica” going to the replica, so in the file above both URLs would point to the local pgBouncer with the same user, password, host and port, but different database name. There are many possibilities how this could be setup! For more information on Makara, [see their documentation](https://github.com/taskrabbit/makara#databaseyml).
|
||||
|
||||
{{< hint style="warning" >}}
|
||||
Sidekiq cannot reliably use read-replicas because even the tiniest replication lag leads to failing jobs due to queued up records not being found.
|
||||
|
|
|
|||
|
|
@ -61,7 +61,7 @@ Note the following:
|
|||
* We are requesting a `grant_type` of `authorization_code`, which still defaults to giving us the `read` scope. However, while authorizing our user, we requested a certain `scope` -- pass the exact same value here.
|
||||
* The `code` can only be used once. If you need to obtain a new token, you will need to have the user authorize again by repeating the above [Authorize the user]({{< relref "client/authorized#authorize-the-user" >}}) step.
|
||||
|
||||
The response of this method is a [Token]({{< relref "entities/token" >}}) entity. We will need the `access_token` value. Once you have the access token, save it in your local cache. To use it in requests, add the HTTP header `Authorization: Bearer ...` to any API call that requires OAuth (i.e., one that is not publicly accessible). Let's verify that our obtained credentials are working by calling [GET /api/v1/accounts/verify\_credentials]({{< relref "methods/accounts#verify_credentials" >}}):
|
||||
The response of this method is a [Token]({{< relref "entities/token" >}}) entity. We will need the `access_token` value. Once you have the access token, save it in your local cache. To use it in requests, add the HTTP header `Authorization: Bearer ...` to any API call that requires OAuth (i.e., one that is not publicly accessible). Let's verify that our obtained credentials are working by calling [GET /api/v1/accounts/verify_credentials]({{< relref "methods/accounts#verify_credentials" >}}):
|
||||
|
||||
```bash
|
||||
curl \
|
||||
|
|
@ -79,7 +79,7 @@ With our OAuth token for the authorized user, we can now perform any action as t
|
|||
|
||||
* See [POST /api/v1/statuses]({{< relref "methods/statuses#create" >}}) for how to create statuses.
|
||||
* See [/api/v1/media]({{< relref "methods/media" >}}) for creating media attachments.
|
||||
* See [/api/v1/scheduled\_statuses]({{< relref "methods/scheduled_statuses" >}}) for managing scheduled statuses.
|
||||
* See [/api/v1/scheduled_statuses]({{< relref "methods/scheduled_statuses" >}}) for managing scheduled statuses.
|
||||
|
||||
### Interact with timelines {#timelines}
|
||||
|
||||
|
|
@ -87,7 +87,7 @@ With our OAuth token for the authorized user, we can now perform any action as t
|
|||
* See [/api/v1/markers]({{< relref "methods/markers" >}}) for saving and loading positions in timelines.
|
||||
* See [/api/v1/statuses]({{< relref "methods/statuses" >}}) for performing actions on statuses.
|
||||
* See [/api/v1/polls]({{< relref "methods/polls" >}}) for viewing and voting on polls.
|
||||
* See [/api/v1/lists]({{< relref "methods/lists" >}}) for obtaining list IDs to use with [GET /api/v1/timelines/list/:list\_id]({{< relref "methods/timelines#list" >}}).
|
||||
* See [/api/v1/lists]({{< relref "methods/lists" >}}) for obtaining list IDs to use with [GET /api/v1/timelines/list/:list_id]({{< relref "methods/timelines#list" >}}).
|
||||
* See [/api/v1/conversations]({{< relref "methods/conversations" >}}) for obtaining direct conversations.
|
||||
* See [/api/v1/favourites]({{< relref "methods/favourites" >}}) for listing favourites.
|
||||
* See [/api/v1/bookmarks]({{< relref "methods/bookmarks" >}}) for listing bookmarks.
|
||||
|
|
@ -95,7 +95,7 @@ With our OAuth token for the authorized user, we can now perform any action as t
|
|||
### Interact with other users {#accounts}
|
||||
|
||||
* See [/api/v1/accounts]({{< relref "methods/accounts" >}}) for performing actions on other users.
|
||||
* See [/api/v1/follow\_requests]({{< relref "methods/follow_requests" >}}) for handling follow requests.
|
||||
* See [/api/v1/follow_requests]({{< relref "methods/follow_requests" >}}) for handling follow requests.
|
||||
* See [/api/v1/mutes]({{< relref "methods/mutes" >}}) for listing mutes.
|
||||
* See [/api/v1/blocks]({{< relref "methods/blocks" >}}) for listing blocks.
|
||||
|
||||
|
|
@ -112,13 +112,13 @@ With our OAuth token for the authorized user, we can now perform any action as t
|
|||
### Use safety features {#safety}
|
||||
|
||||
* See [/api/v1/filters]({{< relref "methods/filters" >}}) for managing filtered keywords.
|
||||
* See [/api/v1/domain\_blocks]({{< relref "methods/domain_blocks" >}}) for managing blocked domains.
|
||||
* See [/api/v1/domain_blocks]({{< relref "methods/domain_blocks" >}}) for managing blocked domains.
|
||||
* See [/api/v1/reports]({{< relref "methods/reports" >}}) for creating reports.
|
||||
* See [/api/v1/admin]({{< relref "methods/admin" >}}) for moderator actions.
|
||||
|
||||
### Manage account info {#manage}
|
||||
|
||||
* See [/api/v1/endorsements]({{< relref "methods/endorsements" >}}) for managing a user profile's featured accounts.
|
||||
* See [/api/v1/featured\_tags]({{< relref "methods/featured_tags" >}}) for managing a user profile's featured hashtags.
|
||||
* See [/api/v1/featured_tags]({{< relref "methods/featured_tags" >}}) for managing a user profile's featured hashtags.
|
||||
* See [/api/v1/preferences]({{< relref "methods/preferences" >}}) for reading user preferences.
|
||||
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ menu:
|
|||
|
||||
* [apex-mastodon](https://github.com/tzmfreedom/apex-mastodon)
|
||||
|
||||
## C\# (.NET Standard) {#c-net-standard}
|
||||
## C# (.NET Standard) {#c-net-standard}
|
||||
|
||||
* [Mastodot](https://github.com/yamachu/Mastodot)
|
||||
* [Mastonet](https://github.com/glacasa/Mastonet)
|
||||
|
|
|
|||
|
|
@ -85,8 +85,8 @@ Now that we are familiar with how to make requests and how to handle responses,
|
|||
* Once you know an account's id, you can use [GET /api/v1/accounts/:id]({{< relref "methods/accounts" >}}) to view the [Account]({{< relref "entities/account" >}}) entity.
|
||||
* To view public statuses posted by that account, you can use [GET /api/v1/accounts/:id/statuses]({{< relref "methods/statuses" >}}) and parse the resulting array of [Status]({{< relref "entities/status" >}}) entities.
|
||||
* Once you know a status's id, you can use [GET /api/v1/statuses/:id]({{< relref "methods/statuses#get-one" >}}) to view the Status entity.
|
||||
* You can also use [GET /api/v1/statuses/:id/reblogged\_by]({{< relref "methods/statuses#boosted_by" >}}) to view who boosted that status,
|
||||
* or [GET /api/v1/statuses/:id/favourited\_by]({{< relref "methods/statuses#favourited_by" >}}) to view who favourited that status.
|
||||
* You can also use [GET /api/v1/statuses/:id/reblogged_by]({{< relref "methods/statuses#boosted_by" >}}) to view who boosted that status,
|
||||
* or [GET /api/v1/statuses/:id/favourited_by]({{< relref "methods/statuses#favourited_by" >}}) to view who favourited that status.
|
||||
* Requesting [GET /api/v1/statuses/:id/context]({{< relref "methods/statuses#context" >}}) will show you the ancestors and descendants of that status in the tree that is the conversational thread.
|
||||
* If the status has a poll attached, you can use [GET /api/v1/polls/:id]({{< relref "methods/polls" >}}) to view the poll separately.
|
||||
|
||||
|
|
@ -99,7 +99,7 @@ One last thing you can do with anonymous requests is to view information about t
|
|||
* View general information with [GET /api/v1/instance]({{< relref "methods/instance#fetch-instance" >}}),
|
||||
* view its peers with [GET /api/v1/instance/peers]({{< relref "methods/instance#peers" >}}) or
|
||||
* its weekly activity with [GET /api/v1/instance/activity]({{< relref "methods/instance#activity" >}}), or to
|
||||
* list all custom emoji available with [GET /api/v1/custom\_emojis]({{< relref "methods/custom_emojis" >}}).
|
||||
* list all custom emoji available with [GET /api/v1/custom_emojis]({{< relref "methods/custom_emojis" >}}).
|
||||
* See [GET /api/v1/directory]({{< relref "methods/directory" >}}) for a directory of all available profiles.
|
||||
* See [GET /api/v1/trends]({{< relref "methods/trends" >}}) for currently trending hashtags.
|
||||
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@ In the above example, we specify the client name and website, which will be show
|
|||
* `redirect_uris` has been set to the "out of band" token generation, which means that any generated tokens will have to be copied and pasted manually. The parameter is called `redirect_uris` because it is possible to define more than one redirect URI, but when generating the token, we will need to provide a URI that is included within this list.
|
||||
* `scopes` allow us to define what permissions we can request later. However, the requested scope later can be a subset of these registered scopes. See [OAuth Scopes]({{< relref "api/oauth-scopes" >}}) for more information.
|
||||
|
||||
We should see an Application entity returned, but for now we only care about client\_id and client\_secret. These values will be used to generate access tokens, so they should be cached for later use. See [POST /api/v1/apps]({{< relref "methods/apps#create" >}}) for more details on registering applications.
|
||||
We should see an Application entity returned, but for now we only care about client_id and client_secret. These values will be used to generate access tokens, so they should be cached for later use. See [POST /api/v1/apps]({{< relref "methods/apps#create" >}}) for more details on registering applications.
|
||||
|
||||
## Example authentication code flow {#flow}
|
||||
|
||||
|
|
@ -52,7 +52,7 @@ Note the following:
|
|||
* `redirect_uri` must be one of the URIs defined when registering the application.
|
||||
* We are requesting a `grant_type` of `client_credentials`, which defaults to giving us the `read` scope.
|
||||
|
||||
The response of this method is a [Token]({{< relref "entities/token" >}}) entity. We will need the `access_token` value. Once you have the access token, save it in your local cache. To use it in requests, add the HTTP header `Authorization: Bearer ...` to any API call that requires OAuth (i.e., one that is not publicly accessible). Let's verify that our obtained credentials are working by calling [GET /api/v1/apps/verify\_credentials]({{< relref "methods/apps#verify_credentials" >}}):
|
||||
The response of this method is a [Token]({{< relref "entities/token" >}}) entity. We will need the `access_token` value. Once you have the access token, save it in your local cache. To use it in requests, add the HTTP header `Authorization: Bearer ...` to any API call that requires OAuth (i.e., one that is not publicly accessible). Let's verify that our obtained credentials are working by calling [GET /api/v1/apps/verify_credentials]({{< relref "methods/apps#verify_credentials" >}}):
|
||||
|
||||
```bash
|
||||
curl \
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ end
|
|||
|
||||
The first available resource is :statuses, which is nested under the :api and :v1 namespaces. Thus, the resulting HTTP route will be /api/v1/statuses. The `only` defines certain allowed methods, which are to be defined in the controller at `app/controllers/api/v1/statuses_controller.rb`.
|
||||
|
||||
Within /api/v1/statuses, there is a scope for a module :statuses, where additional resources are defined. The controllers for these resources live in `app/controllers/api/v1/statuses/`. For example, :favourite will be handled by the \#create action within `app/controllers/api/v1/statuses/favourites_controller.rb` and :unfavourite will be handled within the same controller, but by the \#destroy action.
|
||||
Within /api/v1/statuses, there is a scope for a module :statuses, where additional resources are defined. The controllers for these resources live in `app/controllers/api/v1/statuses/`. For example, :favourite will be handled by the #create action within `app/controllers/api/v1/statuses/favourites_controller.rb` and :unfavourite will be handled within the same controller, but by the #destroy action.
|
||||
|
||||
There is also a custom method defined for any `member` within this scope, or in other words, for any status to be controlled by `app/controllers/api/v1/statuses_controller.rb`, which is mapped to GET /api/v1/statuses/:id/context and handled by the :context action defined within that controller.
|
||||
|
||||
|
|
@ -45,23 +45,23 @@ There is also a custom method defined for any `member` within this scope, or in
|
|||
|
||||
#### :index
|
||||
|
||||
Maps to HTTP GET, for a list. Handled by the \#index action in a controller.
|
||||
Maps to HTTP GET, for a list. Handled by the #index action in a controller.
|
||||
|
||||
#### :show
|
||||
|
||||
Maps to HTTP GET, for a single view. Handled by the \#show action in a controller.
|
||||
Maps to HTTP GET, for a single view. Handled by the #show action in a controller.
|
||||
|
||||
#### :create
|
||||
|
||||
Maps to HTTP POST. Handled by the \#create action in a controller.
|
||||
Maps to HTTP POST. Handled by the #create action in a controller.
|
||||
|
||||
#### :update
|
||||
|
||||
Maps to HTTP PUT. Handled by the \#update action in a controller.
|
||||
Maps to HTTP PUT. Handled by the #update action in a controller.
|
||||
|
||||
#### :destroy
|
||||
|
||||
Maps to HTTP DELETE. Handled by the \#destroy action in a controller.
|
||||
Maps to HTTP DELETE. Handled by the #destroy action in a controller.
|
||||
|
||||
## .well-known {#well-known}
|
||||
|
||||
|
|
@ -114,18 +114,18 @@ The sections below this point are under construction.
|
|||
* /api/proofs
|
||||
* /api/v1
|
||||
* [statuses]({{< relref "methods/statuses" >}}) [create, show, destroy]
|
||||
* reblogged\_by [index]
|
||||
* favourited\_by [index]
|
||||
* reblogged_by [index]
|
||||
* favourited_by [index]
|
||||
* reblog [create]
|
||||
* unreblog [POST reblog\#destroy]
|
||||
* unreblog [POST reblog#destroy]
|
||||
* favourite [create]
|
||||
* unfavourite [POST favourites\#destroy]
|
||||
* unfavourite [POST favourites#destroy]
|
||||
* bookmark [create]
|
||||
* unbookmark [POST bookmarks\#destroy]
|
||||
* unbookmark [POST bookmarks#destroy]
|
||||
* mute [create]
|
||||
* unmute [POST mutes\#destroy]
|
||||
* unmute [POST mutes#destroy]
|
||||
* pin [create]
|
||||
* unpin [POST pins\#destroy]
|
||||
* unpin [POST pins#destroy]
|
||||
* context [GET]
|
||||
* [timelines]({{< relref "methods/timelines" >}})
|
||||
* home [show]
|
||||
|
|
@ -133,9 +133,9 @@ The sections below this point are under construction.
|
|||
* tag [show]
|
||||
* list [show]
|
||||
* [streaming]({{< relref "methods/streaming" >}}) [index]
|
||||
* [custom\_emojis]({{< relref "methods/custom_emojis" >}}) [index]
|
||||
* [custom_emojis]({{< relref "methods/custom_emojis" >}}) [index]
|
||||
* [suggestions]({{< relref "methods/suggestions" >}}) [index, destroy]
|
||||
* [scheduled\_statuses]({{< relref "methods/scheduled_statuses" >}}) [index, show, update, destroy]
|
||||
* [scheduled_statuses]({{< relref "methods/scheduled_statuses" >}}) [index, show, update, destroy]
|
||||
* [preferences]({{< relref "methods/preferences" >}}) [index]
|
||||
* [conversations]({{< relref "methods/conversations" >}}) [index, destroy]
|
||||
* read [POST]
|
||||
|
|
@ -150,29 +150,29 @@ The sections below this point are under construction.
|
|||
* [endorsements]({{< relref "methods/endorsements" >}}) [index]
|
||||
* [markers]({{< relref "methods/markers" >}}) [index, create]
|
||||
* [apps]({{< relref "methods/apps" >}}) [create]
|
||||
* verify\_credentials [credentials\#show]
|
||||
* verify_credentials [credentials#show]
|
||||
* [instance]({{< relref "methods/instance" >}}) [show]
|
||||
* peers [index]
|
||||
* activity [show]
|
||||
* [domain\_blocks]({{< relref "methods/domain_blocks" >}}) [show, create, destroy]
|
||||
* [domain_blocks]({{< relref "methods/domain_blocks" >}}) [show, create, destroy]
|
||||
* [directory]({{< relref "methods/directory" >}}) [show]
|
||||
* [follow\_requests]({{< relref "methods/follow_requests" >}}) [index]
|
||||
* [follow_requests]({{< relref "methods/follow_requests" >}}) [index]
|
||||
* authorize [POST]
|
||||
* reject [POST]
|
||||
* [notifications]({{< relref "methods/notifications" >}}) [index, show]
|
||||
* clear [POST]
|
||||
* dismiss [POST]
|
||||
* [accounts]({{< relref "methods/accounts" >}})
|
||||
* verify\_credentials [GET credentials\#show]
|
||||
* update\_credentials [PATCH credentials\#update]
|
||||
* search [show (search\#index)]
|
||||
* verify_credentials [GET credentials#show]
|
||||
* update_credentials [PATCH credentials#update]
|
||||
* search [show (search#index)]
|
||||
* relationships [index]
|
||||
* [accounts]({{< relref "methods/accounts" >}}) [create, show]
|
||||
* statuses [index accounts/statuses]
|
||||
* followers [index accounts/follower\_accounts]
|
||||
* following [index accounts/following\_accounts]
|
||||
* followers [index accounts/follower_accounts]
|
||||
* following [index accounts/following_accounts]
|
||||
* lists [index accounts/lists]
|
||||
* identity\_proofs [index accounts/identity\_proofs]
|
||||
* identity_proofs [index accounts/identity_proofs]
|
||||
* follow [POST]
|
||||
* unfollow [POST]
|
||||
* block [POST]
|
||||
|
|
@ -182,9 +182,9 @@ The sections below this point are under construction.
|
|||
* pin [POST]
|
||||
* unpin [POST]
|
||||
* [lists]({{< relref "methods/lists" >}}) [index, create, show, update, destroy]
|
||||
* accounts [POST accounts/pins\#destroy]
|
||||
* [featured\_tags]({{< relref "methods/featured_tags" >}}) [index, create, destroy]
|
||||
* suggestions [GET suggestions\#index]
|
||||
* accounts [POST accounts/pins#destroy]
|
||||
* [featured_tags]({{< relref "methods/featured_tags" >}}) [index, create, destroy]
|
||||
* suggestions [GET suggestions#index]
|
||||
* [polls]({{< relref "methods/polls" >}}) [create, show]
|
||||
* votes [create polls/votes]
|
||||
* [push]({{< relref "methods/push" >}})
|
||||
|
|
@ -196,12 +196,12 @@ The sections below this point are under construction.
|
|||
* unsuspend [POST]
|
||||
* approve [POST]
|
||||
* reject [POST]
|
||||
* action [create account\_actions]
|
||||
* action [create account_actions]
|
||||
* reports [index, show]
|
||||
* assign\_to\_self [POST]
|
||||
* assign_to_self [POST]
|
||||
* unassign [POST]
|
||||
* reopen [POST]
|
||||
* resolve [POST]
|
||||
* /api/v2
|
||||
* [search]({{< relref "methods/search" >}}) [GET search\#index]
|
||||
* [search]({{< relref "methods/search" >}}) [GET search#index]
|
||||
|
||||
|
|
|
|||
|
|
@ -63,7 +63,7 @@ aliases: [
|
|||
|
||||
### `name` {#name}
|
||||
|
||||
**Description:** The value of the hashtag after the \# sign.\
|
||||
**Description:** The value of the hashtag after the # sign.\
|
||||
**Type:** String\
|
||||
**Version history:**\
|
||||
0.9.0 - added
|
||||
|
|
|
|||
|
|
@ -112,7 +112,7 @@ View public statuses containing the given hashtag.
|
|||
##### Path parameters
|
||||
|
||||
:hashtag
|
||||
: {{<required>}} String. The name of the hashtag (not including the \# symbol).
|
||||
: {{<required>}} String. The name of the hashtag (not including the # symbol).
|
||||
|
||||
##### Headers
|
||||
|
||||
|
|
@ -151,7 +151,7 @@ limit
|
|||
#### Response
|
||||
##### 200: OK
|
||||
|
||||
Sample timeline for the hashtag \#cats and limit=2
|
||||
Sample timeline for the hashtag #cats and limit=2
|
||||
|
||||
```json
|
||||
[
|
||||
|
|
|
|||
|
|
@ -218,19 +218,19 @@ published
|
|||
|
||||
## HTML sanitization {#sanitization}
|
||||
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/lib/sanitize_config.rb" caption="app/lib/sanitize\_config.rb" >}}
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/lib/sanitize_config.rb" caption="app/lib/sanitize_config.rb" >}}
|
||||
|
||||
Mastodon sanitizes incoming HTML in order to not break assumptions for API client developers. Supported elements include `<p>`, `<span>`, `<br>`, and `<a>`. Unsupported elements will be converted to `<p>`.The sanitizer will keep classes if they begin with microformats prefixes or are semantic classes:
|
||||
|
||||
* h-\*
|
||||
* p-\*
|
||||
* u-\*
|
||||
* dt-\*
|
||||
* e-\*
|
||||
* mention
|
||||
* hashtag
|
||||
* ellipsis
|
||||
* invisible
|
||||
- h-*
|
||||
- p-*
|
||||
- u-*
|
||||
- dt-*
|
||||
- e-*
|
||||
- mention
|
||||
- hashtag
|
||||
- ellipsis
|
||||
- invisible
|
||||
|
||||
## JSON-LD Namespacing {#namespaces}
|
||||
|
||||
|
|
@ -240,51 +240,51 @@ published
|
|||
|
||||
Contains definitions for Mastodon features.
|
||||
|
||||
* toot:Emoji
|
||||
* toot:IdentityProof
|
||||
* toot:blurhash
|
||||
* toot:focalPoint
|
||||
* toot:featured
|
||||
* toot:featuredTags
|
||||
* toot:discoverable
|
||||
* toot:suspended
|
||||
* toot:votersCount
|
||||
- toot:Emoji
|
||||
- toot:IdentityProof
|
||||
- toot:blurhash
|
||||
- toot:focalPoint
|
||||
- toot:featured
|
||||
- toot:featuredTags
|
||||
- toot:discoverable
|
||||
- toot:suspended
|
||||
- toot:votersCount
|
||||
|
||||
### ActivityStreams extensions (`as:`) {#as}
|
||||
|
||||
Contains ActivityStreams extended properties that have been proposed but not officially adopted yet.
|
||||
|
||||
* as:Hashtag
|
||||
* as:alsoKnownAs
|
||||
* as:manuallyApprovesFollowers
|
||||
* as:movedTo
|
||||
* as:sensitive
|
||||
- as:Hashtag
|
||||
- as:alsoKnownAs
|
||||
- as:manuallyApprovesFollowers
|
||||
- as:movedTo
|
||||
- as:sensitive
|
||||
|
||||
### W3ID Security Vocabulary (`sec:`) {#sec}
|
||||
|
||||
Contains properties used for HTTPS Signatures and Linked Data Signatures. Also used for identity proofs. See [Security]({{< relref "spec/security" >}}) for more information.
|
||||
|
||||
* sec:publicKey
|
||||
* sec:publicKeyPem
|
||||
* sec:owner
|
||||
* sec:signature
|
||||
* sec:signatureValue
|
||||
- sec:publicKey
|
||||
- sec:publicKeyPem
|
||||
- sec:owner
|
||||
- sec:signature
|
||||
- sec:signatureValue
|
||||
|
||||
#### W3ID Identity
|
||||
|
||||
Contains a collection of terms from various namespaces, used for Linked Data Signatures.
|
||||
|
||||
* dc:creator
|
||||
* dc:created
|
||||
* sec:signature
|
||||
* sec:signatureValue
|
||||
- dc:creator
|
||||
- dc:created
|
||||
- sec:signature
|
||||
- sec:signatureValue
|
||||
|
||||
### schema.org extensions (`schema:`) {#schema}
|
||||
|
||||
Contains properties used for profile metadata.
|
||||
|
||||
* schema:PropertyValue
|
||||
* schema:value
|
||||
- schema:PropertyValue
|
||||
- schema:value
|
||||
|
||||
## Extensions
|
||||
|
||||
|
|
|
|||
|
|
@ -75,7 +75,7 @@ This request is functionally equivalent to saying that `https://my-example.com/a
|
|||
|
||||
### Verifying HTTP signatures {#http-verify}
|
||||
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/controllers/concerns/signature_verification.rb" caption="app/controllers/concerns/signature\_verification.rb" >}}
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/controllers/concerns/signature_verification.rb" caption="app/controllers/concerns/signature_verification.rb" >}}
|
||||
|
||||
Consider the following request:
|
||||
|
||||
|
|
@ -97,7 +97,7 @@ Mastodon verifies the signature using the following algorithm:
|
|||
|
||||
## Linked Data Signatures {#ld}
|
||||
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/lib/activitypub/linked_data_signature.rb" caption="app/lib/activitypub/linked\_data\_signature.rb" >}}
|
||||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/master/app/lib/activitypub/linked_data_signature.rb" caption="app/lib/activitypub/linked_data_signature.rb" >}}
|
||||
|
||||
[Linked Data Signatures 1.0](https://w3c-dvcg.github.io/ld-signatures/) is a specification for attaching cryptographic signatures to JSON-LD documents. LD Signatures are not used widely within Mastodon, but they are used in the following situations:
|
||||
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ menu:
|
|||
你必须需要复制如下内容：
|
||||
|
||||
* `~/live/public/system`目录，里面包含了用户上传的图片与视频（如果使用S3，可跳过此步）
|
||||
* Postgres数据库（使用[pg\_dump](https://www.postgresql.org/docs/9.1/static/backup-dump.html)）
|
||||
* Postgres数据库（使用[pg_dump](https://www.postgresql.org/docs/9.1/static/backup-dump.html)）
|
||||
* `~/live/.env.production`文件，里面包含了服务器配置与密钥
|
||||
|
||||
不太重要的部分，为了方便起见，你也可以复制如下内容：
|
||||
|
|
@ -45,7 +45,7 @@ menu:
|
|||
|
||||
### 导出并导入Postgres数据库 {#dump-and-load-postgres}
|
||||
|
||||
不要运行`mastodon:setup`，而是创建一个名为`template0`的空白Postgres数据库（当导入Postgres导出文件时，这是很有用的，参见[pg\_dump文档](https://www.postgresql.org/docs/9.1/static/backup-dump.html#BACKUP-DUMP-RESTORE)）。
|
||||
不要运行`mastodon:setup`，而是创建一个名为`template0`的空白Postgres数据库（当导入Postgres导出文件时，这是很有用的，参见[pg_dump文档](https://www.postgresql.org/docs/9.1/static/backup-dump.html#BACKUP-DUMP-RESTORE)）。
|
||||
|
||||
在你的旧系统，使用`mastodon`用户运行如下命令：
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ menu:
|
|||
parent: admin-optional
|
||||
---
|
||||
|
||||
可以通过TOR的匿名服务来访问Mastodon。这将给你一个只能通过 TOR 网络连接的 \*.onion 地址。
|
||||
可以通过TOR的匿名服务来访问Mastodon。这将给你一个只能通过 TOR 网络连接的 *.onion 地址。
|
||||
|
||||
## 安装 Tor {#install}
|
||||
|
||||
|
|
|
|||
|
|
@ -279,7 +279,7 @@ production:
|
|||
url: postgresql://db_user:db_password@db_host:db_port/db_name
|
||||
```
|
||||
|
||||
确保URL指向PostgreSQL服务器所在位置。你可以添加多个副本（replica）。你可以本地安装一个pgBouncer，该pgBouncer可被配置为根据数据库名称连接两个不同服务器，例如：“mastodon”连接主服务器，“mastodon\_replica”连接副本服务器，这样上面文件中的两个URL可以使用同样用户名、密码、主机、端口，不同数据库名称。可能的设置有很多！有关Makara的更多信息，请参阅[其文档](https://github.com/taskrabbit/makara#databaseyml)。
|
||||
确保URL指向PostgreSQL服务器所在位置。你可以添加多个副本（replica）。你可以本地安装一个pgBouncer，该pgBouncer可被配置为根据数据库名称连接两个不同服务器，例如：“mastodon”连接主服务器，“mastodon_replica”连接副本服务器，这样上面文件中的两个URL可以使用同样用户名、密码、主机、端口，不同数据库名称。可能的设置有很多！有关Makara的更多信息，请参阅[其文档](https://github.com/taskrabbit/makara#databaseyml)。
|
||||
|
||||
{{< hint style="warning" >}}
|
||||
Sidekiq无法可靠的使用只读副本（read-replicas），因为即使是最微小的复制延迟也会导致查询不到相关纪录所致的任务失败。
|
||||
|
|
|
|||
|
|
@ -51,7 +51,7 @@ RAILS_ENV=production bin/tootctl help
|
|||
|
||||
## 帐户相关命令 {#accounts}
|
||||
|
||||
{{< caption-link url="https://github.com/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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/mastodon/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}
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue