mirror of
https://iceshrimp.dev/Crimekillz/jointrashposs.git
synced 2024-11-22 00:43:50 +01:00
migrate docs
This commit is contained in:
kakkokari-gtyih
parent
18aa92b80d
commit
a8dca2c347
9
content/.README.md
Normal file
9
content/.README.md
Normal file
@ -0,0 +1,9 @@
|
||||
# **DO NOT edit locale files** except `ja-JP` directory.
|
||||
|
||||
When you add files/text to the ja-JP directory (of misskey-dev/misskey-hub), it will automatically be applied to other language files.
|
||||
Translations added in ja-JP file should contain the original Japanese strings.
|
||||
|
||||
# 移行作業
|
||||
|
||||
- `.docs-legacy/`内にvuepress時代のファイルを格納
|
||||
- `docs/`内にディレクトリ構造を作成中
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
date: 2021-11-05
|
||||
description: '2021年も恒例のMisskey Advent Calendarが企画されています。'
|
||||
---
|
||||
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
---
|
||||
date: 2021-12-01
|
||||
description: 'Misskey Advent Calendar 2021 1日目の記事です。Misskey Hubの実装について紹介します。'
|
||||
---
|
||||
|
||||
# インサイド Misskey Hub
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
この記事は、[Misskey Advent Calendar 2021](https://adventar.org/calendars/6273) 1日目の記事です。
|
||||
:::
|
||||
|
||||
@ -27,7 +28,7 @@ description: 'Misskey Advent Calendar 2021 1日目の記事です。Misskey Hub
|
||||
Misskey Hubの実装について理解するためには、いくつかの前提知識が必要となるので、まずそれらの説明をします。ひとつめは静的サイトについて、ふたつめはSSGについてです。それでは始めましょう🚀
|
||||
|
||||
## 静的サイト is 何
|
||||
::: warning
|
||||
:::warning
|
||||
**性的サイト**と誤変換しやすいので注意
|
||||
:::
|
||||
|
||||
@ -40,7 +41,7 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
|
||||
|
||||
静的なサイトは逆に、そういったリッチなことは行わず、**予め用意したコンテンツをどのユーザーに対しても同じように表示するだけのサイト**です。Misskey Hubは(サイト更新を除けば)誰がいつ見ても同じ内容なので、静的サイトです。
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
技術的な話になりますが、静的と言っても、静的なのは「サーバーから」送られてくる内容だけであって、JavaScriptを使ってブラウザ上で動的にページの内容を変えることは可能です。
|
||||
例えばMisskey Hubでは、サイドバーに表示されるMisskeyや藍ちゃんの広告はページを訪れるたびにランダムで変わるようになっています。\
|
||||
さらに言うと、静的サイト内に別の動的サイトを埋め込んで表示することも可能です。これを利用して、将来的にはそのページに対するMisskeyのコメントタイムラインをページに表示する、といったことも実装されるかもしれません。
|
||||
@ -62,7 +63,7 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
|
||||
|
||||
動的サイトを運営する際に発生するそのような諸々の心配から解放されるというのは非常に大きなメリットです。つまり、金銭面においても精神面においても、**ゼロコスト**でMisskey Hubを運用できます。
|
||||
|
||||
::: details さらに技術的な話(危険)
|
||||
:::details さらに技術的な話(危険)
|
||||
ここまで言っておいてなんですが、先ほど言った
|
||||
|
||||
> もちろんMisskeyは動的サイトということになります。
|
||||
@ -120,7 +121,7 @@ Misskey Hubもプラグイン機能を使っていて、「関連するページ
|
||||
|
||||
さらに、MFMを実際に書いて試せるプレイグラウンド機能や、APIリファレンスにおけるAPIコンソールなども今後実装予定です。
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
「関連するページ」「最近更新されたページ」は我ながら便利機能だと思っているので、Misskey Hub以外のvuepressを採用したサイトでも使えるようにnpmで一般公開しようかとも考えています。
|
||||
:::
|
||||
|
||||
@ -149,15 +150,15 @@ vuepress標準の機能で、右上にあるやつです。各ページの見出
|
||||
## ページ
|
||||
各ページはMarkdown(MFMみたいなもの(いや本来はMFMが「Markdownのようなもの」という立ち位置だけれども))というマークアップ言語で書かれています。Markdownを使うことで、簡単に見出し、リンク、画像、表といった要素を表現できるほか、
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
こんな
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
感じの
|
||||
:::
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
メッセージ
|
||||
:::
|
||||
|
||||
@ -195,7 +196,7 @@ Misskey Hub内のMisskey Hub説明ページにもあるように、Misskey Hub
|
||||
|
||||
各インスタンス紹介は、インスタンス側で用意されたプロフィールレンダリングページをiframeというHTMLの機能で埋め込んで表示するようになっています。したがって、一度Misskey Hubにインスタンスを登録してしまえば、インスタンスの名前、説明、バナー画像といった情報を更新した場合でもリアルタイムでインスタンス一覧に反映されます。
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
インスタンス一覧へ掲載するインスタンスを募集しています。お気軽にご連絡ください🤗
|
||||
:::
|
||||
|
||||
@ -215,7 +216,7 @@ Misskey Hubにおいては、GitHub ActionsというGitHubの機能を利用し
|
||||
|
||||
GitHub Pagesは前述した「静的サイトを提供してくれる機能」です。GitHubのインフラストラクチャ上で動くため、いちどデプロイしてしまえば、あとは何の心配もなくMisskey Hubが提供され続けます。
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
「何の心配もなく」はちょっと言い過ぎたかもしれません。というのも、(強いていうと)ひとつだけ心配があって、それはドメインです。Misskey Hubはmisskey-hub.netというドメインで提供されていますが、これは私が用意したものです。そのため、もし万が一私がドメインの更新を忘れるとMisskey Hubに繋がらなくなりますが、そこは𝑇𝑟𝑢𝑠𝑡 𝑚𝑒
|
||||
:::
|
||||
|
||||
@ -238,7 +239,7 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
|
||||
|
||||
静的サイトはいいぞ。vuepressはいいぞ。Misskey Hubに幸あれ🙏
|
||||
|
||||
::: details Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉
|
||||
:::details Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉
|
||||
> いかがでしたか？
|
||||
:::
|
||||
|
||||
@ -256,6 +257,6 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
|
||||
|
||||
栄養があるし、加熱不要で調理も楽(ハサミで切って味噌に突っ込んでチンするだけで味噌汁できる)
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
ただし加熱しないと風味が強すぎ、ちょっとしたワサビ食べてるみたいになるので多少訓練が必要
|
||||
:::
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
date: 2022-02-11
|
||||
description: 'MFMで使われている技術や考え方について紹介します。'
|
||||
---
|
||||
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
date: 2023-02-08
|
||||
description: 'Misskey開発に貢献すると報奨金がもらえるキャンペーンを行います。 We offer campaigns you to recieve rewards for contributing to the development of Misskey.'
|
||||
---
|
||||
|
||||
@ -8,7 +9,7 @@ We offer campaigns you to recieve rewards for contributing to the development of
|
||||
|
||||
<https://misskey.io/notes/9auj9aj1ww>
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
条件や報奨金の額は、予告なく変更になる場合があります。
|
||||
Conditions and reward amounts are subject to change without notice.
|
||||
|
||||
@ -16,7 +17,7 @@ Conditions and reward amounts are subject to change without notice.
|
||||
In addition to those, benefits are being paid at irregular intervals based on contributions.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
報奨金の原資はパトロンの皆様からの寄付で成り立っています。
|
||||
Rewards come from donations from patrons.
|
||||
|
||||
|
||||
@ -12,6 +12,6 @@ The Misskey API cannot be cached.
|
||||
You need to configure the following settings in your CDN
|
||||
- Cache all requests except `/api/*`.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
You don't need to clear the cache when you update Misskey.
|
||||
::::
|
||||
@ -20,7 +20,7 @@ If you have an image file that you would like to turn into a custom emoji you ca
|
||||
This works just like attaching files to a note:
|
||||
You can choose to upload a new file, pick a file from your Misskey drive or upload a file from another URL.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
When you import emoji from your drive, the file will remain inside your drive.
|
||||
Misskey does not make a copy of this file so if you delete it, the emoji will be broken.
|
||||
:::
|
||||
@ -32,7 +32,7 @@ The emoji will be added to the instance and you will then be able to edit or del
|
||||
Emojis can be imported in bulk as packed ZIP files with a special format.
|
||||
This ability can be found in the three dots menu in the top right corner of the custom emoji menu.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Bulk emoji import may overwrite existing emoji or otherwise mess up your instance.
|
||||
Be sure to only import emoji from trusted sources, ideally only ones you exported yourself.
|
||||
:::
|
||||
@ -89,7 +89,7 @@ The properties of an emoji can be edited by clicking it in the list of local emo
|
||||
When you click on a custom emoji, a dialog for editing the properties will open.
|
||||
This dialog will also allow you to delete an emoji.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
When you delete a custom emoji, old notes that contain it will still have the text name of the emoji in it.
|
||||
The emoji will no longer be rendered correctly.
|
||||
:::
|
||||
@ -1,5 +1,5 @@
|
||||
# How to use GitHub Actions to push to Docker Hub
|
||||
::: warning
|
||||
:::warning
|
||||
Sorry, this page is not translated yet. If you can, please edit this page to translate the [Japanese version](/docs/admin/push-docker-hub.md).
|
||||
|
||||
Until then, try using a machine translator.
|
||||
@ -1,6 +1,6 @@
|
||||
# Troubleshooting guide
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Sorry, this page is not translated yet. If you can, please edit this page to translate the [Japanese version](/docs/admin/troubleshooting.html).
|
||||
|
||||
Until then, try using a machine translator.
|
||||
@ -6,7 +6,7 @@ description: 'Misskey exposes an API that you can use to develop Misskey clients
|
||||
Misskey exposes an API that you can use to develop Misskey clients, Misskey-connected web services, bots, etc. ("Applications").
|
||||
We also have a streaming API, so you can create applications with real-time capabilities.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
By using the official Misskey SDK or third party libraries, you can use the API more conveniently, for example by simplifying some of the steps described in this document.
|
||||
See [here](TODO) for more information about libraries.
|
||||
:::
|
||||
@ -18,7 +18,7 @@ This document will walk you through the process of obtaining an access token and
|
||||
The API generally requires an access token to make a request.
|
||||
An access token is a set of credentials associated with a user, which identifies the user using the API and controls what operations each access token is authorised to perform.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
There is a one-to-many relationship between a user and the access token associated with that user, and multiple access tokens can be issued for a given user.
|
||||
:::
|
||||
|
||||
@ -27,14 +27,14 @@ You can easily [obtain an access token for yourself](#Manually-issue-an-access-t
|
||||
### Manually issue an access token
|
||||
You can issue your own access token in Misskey Web under 'Settings > API'.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Please do not share your access token with anyone.
|
||||
:::
|
||||
|
||||
### Request an access token to be issued
|
||||
To obtain an access token for a user of the application ( simply "the user"), you can request it to be issued in the following way.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
The method described below is called MiAuth, ant it issues an instant access token without creating an app.
|
||||
|
||||
You can still [create an app to obtain access token](./app.md).
|
||||
@ -43,7 +43,7 @@ You can still [create an app to obtain access token](./app.md).
|
||||
#### Step 1
|
||||
Generate a UUID. This will be referred to as the **session ID** from now on.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
This session ID should be generated each time and should not be reused.
|
||||
:::
|
||||
|
||||
@ -67,7 +67,7 @@ You can also set a few options as query parameters to the URL:
|
||||
| `callback` | The URL to which the user will be redirected after authentication, with the session ID added to the redirect with the query parameter `session`. |
|
||||
| `permission` | The permissions that the application requires. <br>List the permissions to be requested, separated by `,`. The list of permissions can be found [here](TODO). |
|
||||
|
||||
::: tip Example
|
||||
:::tip Example
|
||||
```:no-line-numbers
|
||||
https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permisson=write:notes,write:following,read:drive
|
||||
```
|
||||
@ -94,7 +94,7 @@ The properties included in the response are as follows:
|
||||
## Using the API
|
||||
Once you have your API access token, you can use the API by making requests to the various endpoints.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
|
||||
- All HTTP APIs are POST, and both request and response are in JSON format (excluding drive/files/create).
|
||||
- Specify `Content-Type: application/json` in the request header.
|
||||
@ -115,12 +115,12 @@ The access token is included in the request body JSON at the parameter `i`.
|
||||
|
||||
For more information on the API, see the [API Reference](./endpoints.html).
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Misskey does not use REST.
|
||||
:::
|
||||
|
||||
In addition to the HTTP API, Misskey also provides a streaming API. More information about the streaming API can be found [here](./streaming/).
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Your Misskey instance also provides API documentation at `/api-doc`.
|
||||
:::
|
||||
@ -4,7 +4,7 @@ description: 'The streaming API provides real-time information (e.g., new posts
|
||||
|
||||
# Streaming API
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
You should read the [Misskey API documentation](../index.md) first.
|
||||
:::
|
||||
|
||||
@ -24,7 +24,7 @@ where
|
||||
- `{host}` is the host of the instance you want to connect to.
|
||||
- `{token}` is the users access token.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
You can also connect without the access token, but this will limit the information you receive and operations you can perform.
|
||||
:::
|
||||
|
||||
@ -38,7 +38,7 @@ To receive such events, you need to join a **channel** on the stream, as describ
|
||||
Misskey's streaming API has the concept of channels. This is a mechanism for separating the information to be sent and received.
|
||||
By joining channels on the stream, you will be able to receive various kinds of information and send information.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
You can join multiple channels simultaneously on a single stream connection.
|
||||
:::
|
||||
|
||||
@ -65,7 +65,7 @@ where
|
||||
- `id` is an arbitrary ID for interacting with that channel. This is necessary to identify which channel the message is coming from, because a stream contains multiple channels. This ID can be something like a UUID or a random number.
|
||||
- `params` are parameters required when joining a channel. Different channels require different parameters when connecting. When connecting to a channel that does not require parameters, this property can be omitted.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
The ID is not per channel but per channel connection, because a channel may be needed multiple times but with different parameters.
|
||||
:::
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
Misskey can display ads in the instance timeline and other places if enabled by the instance administrator.
|
||||
You can reduce how often an ad is shown by clicking in the upper right corner of it.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
If the total number of ads being shown on the instance is small then an ad may still be shown to you often even after you choose to reduce how often it is displayed.
|
||||
:::
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Drive is a feature that allows you to manage your files on Misskey.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Technically speaking, the drive can be seen as an interface where all the files are centrally managed on Misskey's system, which is also open to users.
|
||||
:::
|
||||
|
||||
@ -12,7 +12,7 @@ Files uploaded to the drive can be downloaded at any time, or files can be reuse
|
||||
|
||||
You can also create folders on your drive to organize multiple files together.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
At the moment, when you delete a file from your drive, **all the content (notes, pages, etc.)** attached to that file will also be deleted.
|
||||
:::
|
||||
|
||||
@ -5,7 +5,7 @@ description: 'MFM is a dedicated markup language that can be used in various pla
|
||||
# MFM
|
||||
MFM, which stands for Misskey Flavoured Markdown, is a dedicated markup language that can be used in various places on Misskey.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Some of the syntax is compatible with Markdown.
|
||||
:::
|
||||
|
||||
@ -17,7 +17,7 @@ Some of the syntax is compatible with Markdown.
|
||||
|
||||
## Syntax
|
||||
### Mentions
|
||||
::: tip
|
||||
:::tip
|
||||
For more information about Mentions, see [here](./mention.md).
|
||||
:::
|
||||
|
||||
@ -30,7 +30,7 @@ For more information about Mentions, see [here](./mention.md).
|
||||
|
||||
### Hashtags
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
For more information about hashtags, see [here](./hashtag).
|
||||
:::
|
||||
|
||||
@ -40,7 +40,7 @@ For more information about hashtags, see [here](./hashtag).
|
||||
|
||||
### Custom Emoji
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
For more information about custom emoji, see [here](./custom-emoji).
|
||||
:::
|
||||
|
||||
@ -62,7 +62,7 @@ For more information about custom emoji, see [here](./custom-emoji).
|
||||
|
||||
---
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
More available syntax can be found in the **MFM cheat sheet** provided by the Misskey web UI under `/mfm-cheat-sheet` on your instance.
|
||||
:::
|
||||
|
||||
@ -4,11 +4,11 @@ If you don't like a user, you can mute them to make them disappear from your tim
|
||||
Alternatively, you can block a user to prevent them from seeing your content or engaging with you in any way.
|
||||
People won't know that you have muted them, but they will know that you have blocked them. It is up to you to decide which option you prefer.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Mute and block can be used together.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Please consider reporting any users who violate the Terms of Service to the moderators.
|
||||
:::
|
||||
|
||||
@ -25,7 +25,7 @@ If you mute a user, the following content about that user will no longer appear
|
||||
|
||||
To mute a user in Misskey Web, open the menu on the user's profile page and press the "Mute" button.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
They will not be notified that you have muted them, and they will not know that you have muted them.
|
||||
:::
|
||||
|
||||
@ -46,11 +46,11 @@ Also,
|
||||
|
||||
To block a user on Misskey Web, open the menu on the user's profile page and press the "Block" button.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
You will not be notified that you have been blocked by someone, but you will know indirectly that you have been blocked because you will not be able to take any of the above actions, such as following someone.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
The other person will not be able to see your content, but they will be able to see it if they switch accounts or log out. Blocking is only a simple, but useful feature.
|
||||
You can change your privacy settings in Settings > Privacy to make it more difficult for blocked users to view your content by requiring approval for follow requests and setting your default note visibility to "Followers".
|
||||
:::
|
||||
@ -12,11 +12,11 @@ By adding a note to your [Favorites](./favorite), you can easily find it at a la
|
||||
|
||||
To compose a note, press one of the buttons with a pencil icon on your screen to open the posting form (either at the top of your timeline or at the bottom of the navigation menu). Enter the content you want to post in the form, and press the "Note" button to publish it. Notes can contain text, files such as images or videos, and [Polls](./poll). In addition, by using [MFM](./mfm) within your text, you can include [Mentions](./mention) and [Hashtags](./hashtag). There are also other settings such as CW (Content Warning) or note visibility that are explained below.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
If you are on a computer and have an image saved in your clipboard, you can attach it to your note by using the usual paste keyboard shortcut within the text box.
|
||||
:::
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
You can also press <kbd class="key">Ctrl + Enter</kbd> within the text box to publish your note.
|
||||
:::
|
||||
|
||||
@ -24,7 +24,7 @@ You can also press <kbd class="key">Ctrl + Enter</kbd> within the text box to pu
|
||||
|
||||
The act of quoting an existing note or sharing an existing note. The note created as a result of these acts are all called a Renote/RN (or "renoting" as verb). Most of the time, this is used when you want to share a note you like to your own followers, or when you want a share a note that you posted in the past once more. While it is possible to renote the same note multiple times, please be aware that doing so may be seen as annoying by others.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
If you've set your note's visibility to Followers-only or Direct, then others will not be able to renote it.
|
||||
:::
|
||||
|
||||
@ -42,7 +42,7 @@ It's possible to individually set where your note will be visible (Visibility) f
|
||||
|
||||
Your note will be visible to all users and will show up on all timelines (home, local, social, global).
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
This visibility will be unavailable if your account is <a href="./silence">silenced</a>.
|
||||
:::
|
||||
|
||||
@ -74,7 +74,7 @@ If you enable this option, your note won't be federated to remote instances.
|
||||
|
||||
By pinning a note to your profile it will be constantly displayed on your profile page. To pin a note, open the note menu and press "Pin to profile".
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
It's possible to pin multiple notes to your profile.
|
||||
:::
|
||||
|
||||
@ -34,6 +34,6 @@ Your online status is displayed as an indicator in the corner of the user icon o
|
||||
Your online status will change automatically and cannot be set manually.
|
||||
You can set your online status to be private.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Some features, such as user suggestions, may be based on online status, so making your status private may make it harder for other users to find you.
|
||||
:::
|
||||
@ -18,7 +18,7 @@ Usually, ActivityPub's "Like" is implemented as a favorite.
|
||||
|
||||
Since Misskey does not have likes, a "Like" from a remote instance will be displayed as a '👍' reaction.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Your instance administrator may change this to be displayed as a '⭐' reaction.
|
||||
If you are an admin, see [here](../admin/default-reaction.md).
|
||||
:::
|
||||
@ -6,7 +6,7 @@ You can specify a number of options in the URL, including the shared content, as
|
||||
|
||||
## Query Parameters
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
All parameters are **optional**.
|
||||
:::
|
||||
|
||||
@ -45,7 +45,7 @@ The following options allow to select a scope.
|
||||
| `visibleUserIds` | target user IDs |
|
||||
| `visibleAccts` | target user [acct](../glossary.md#acct)s (comma separated) |
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
If `visibility` is set to `specified`, either `visibleUserIds` or `visibleAccts` must be set too.
|
||||
:::
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
# Thread mute
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
This feature is available since version 12.95.0.
|
||||
:::
|
||||
|
||||
@ -10,6 +10,6 @@ If you mute a thread, you will no longer be notified of new replies to that thre
|
||||
|
||||
To mute a thread in Misskey Web, open the menu of any note belonging to the thread in question or the note from which it originated and select 'Mute Thread'.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
The entire thread will be muted, regardless of which note in the thread the mute operation is performed from.
|
||||
:::
|
||||
@ -1,10 +1,10 @@
|
||||
# Webhook
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
This feature is available as of Misskey version 12.109.0.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
This is an experimental feature and may be unstable or subject to change in the future.
|
||||
:::
|
||||
|
||||
@ -5,10 +5,10 @@ To use Misskey, you need to create an account in one of the instances and use th
|
||||
|
||||
You can select an instance of your choice from the [instance list](../instances.md).
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
No matter which instance you choose, you will be able to interact with users on other instances.
|
||||
|
||||
::: details
|
||||
:::details
|
||||
Misskey has the ability to federate.
|
||||
|
||||
Misskey has built-in federation support, which allows users in different instances to follow, react, and renote in the same way as users on the same instance.
|
||||
@ -2,11 +2,11 @@
|
||||
Thank you for your interest in building a Misskey instance 🚀
|
||||
There are several ways to create an instance, so please choose one below and read the guide.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Never change the domain name (hostname) of an instance once you start using it!
|
||||
:::
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
If you use Cloudflare for your own server, do not use the Auto Minify setting.
|
||||
|
||||
Misskey will not work properly because Cloudflare will not interpret the latest JavaScript and will break the source code inside.
|
||||
@ -16,7 +16,7 @@ There is also an update script.
|
||||
2. An Ubuntu Server
|
||||
3. A Cloudflare Account (recommended)
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Never change the domain name (hostname) of an instance once you start using it!
|
||||
:::
|
||||
|
||||
@ -3,11 +3,11 @@ Create Misskey instance with Docker Compose
|
||||
|
||||
This guide describes how to install and setup Misskey with Docker Compose.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Never change the domain name (hostname) of an instance once you start using it!
|
||||
:::
|
||||
|
||||
::: tip Requirement
|
||||
:::tip Requirement
|
||||
- docker and dockercompose installed
|
||||
:::
|
||||
|
||||
@ -56,7 +56,7 @@ GLHF✨
|
||||
|
||||
How to update your Misskey server
|
||||
----------------------------------------------------------------
|
||||
::: warning
|
||||
:::warning
|
||||
When updating, be sure to check the [release notes](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md) to know in advance the changes and whether or not additional work is required (in most cases, it is not).
|
||||
:::
|
||||
|
||||
@ -1,14 +1,14 @@
|
||||
# Create Misskey Instance with Kubernetes/TrueNAS
|
||||
This guide describes how to install and setup Misskey using Kubernetes and Helm charts.
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Never change the domain name (hostname) of an instance once you start using it!
|
||||
:::
|
||||
|
||||
## TrueCharts and TrueNAS Scale
|
||||
The Helm chart for Misskey is hosted on TrueCharts which is a repository designed to be used with TrueNAS Scale, but its charts can also be installed as normal Helm charts. The [TrueCharts](https://truecharts.org/charts/incubator/misskey/) site has a list of all the charts available as well as documentation on how to install. The TrueCharts [Discord](https://discord.gg/Ax9ZgzKx9t) server is also a resource that can be used if you have questions. Misskey is currently on the *incubator* train.
|
||||
|
||||
::: tip Requirements
|
||||
:::tip Requirements
|
||||
- TrueNAS Scale
|
||||
OR
|
||||
- Kubernetes cluster and Helm
|
||||
@ -6,7 +6,7 @@ This guide describes how to install and setup Misskey.
|
||||
|
||||
----------------------------------------------------------------
|
||||
|
||||
::: danger
|
||||
:::danger
|
||||
Never change the domain name (hostname) of an instance once you start using it!
|
||||
:::
|
||||
|
||||
@ -114,7 +114,7 @@ Just `NODE_ENV=production pnpm run start`. GLHF!
|
||||
|
||||
2. Edit it, and paste this and save:
|
||||
|
||||
::: details
|
||||
:::details
|
||||
```
|
||||
[Unit]
|
||||
Description=Misskey daemon
|
||||
@ -150,7 +150,7 @@ You can check if the service is running with `systemctl status misskey`.
|
||||
|
||||
1. Copy the following text to `/etc/init.d/misskey`:
|
||||
|
||||
::: details
|
||||
:::details
|
||||
```sh
|
||||
#!/sbin/openrc-run
|
||||
|
||||
@ -4,7 +4,7 @@ We aim to be the place for "everything Misskey".
|
||||
|
||||
Misskey Hub is [open source](https://github.com/misskey-dev/misskey-hub).
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Misskey Hub is a static site built with [VuePress](https://github.com/vuepress/vuepress-next).
|
||||
:::
|
||||
|
||||
@ -5,7 +5,7 @@ Misskey is an open-source and distributed platform for microblogging. Developmen
|
||||
## History
|
||||
While Misskey started centered around Bulletin Boards as its main feature, the growth in popularity due to the addition of a timeline that let users post short messages and view them in chronological order lead to a gradual shift in the main focus of development towards this kind of functionality. Misskey was not always a decentralized service, but became decentralized through the adoption of ActivityPub in 2018. Since then, it has become a service that is acknowledged and used by many.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n.
|
||||
:::
|
||||
|
||||
@ -17,7 +17,7 @@ A <b>Distributed</b> service, also called a <b>Decentralized</b> service, refers
|
||||
## Always Open-Source
|
||||
Misskey has always been, and will always be, open source.Open source means, simply speaking, <b>making the source code of software (a program) publicly available</b>.This also includes being able to adjust or redistribute the source code in its definition. The entirety of Misskey's source code is [being licensed](https://github.com/misskey-dev) under an open-source license called [AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE), which means anyone can freely inspect, use, adjust, change or redistribute as they see fit. Open source has many merits, including allowing anyone being able to make changes as they like, to make sure the code does not include any harmful components and being able to easily participate in its development. For realizing the distributed nature of Misskey, this concept of open source is indispensable. Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Technically speaking, Misskey's source code is being managed via Git, and its repository is being hosted at [GitHub.](https://github.com/misskey-dev)
|
||||
:::
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
# Release Notes
|
||||
Notes for indivudual misskey releases.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Information updates may not be translated yet. For the latest information see [GitHub](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md).
|
||||
:::
|
||||
|
||||
@ -743,6 +743,6 @@ Released at: 12/03/2021
|
||||
- client: fixed an issue where "All" in user search did not work
|
||||
- client: fixed the style of the Reaction List and Renote List tooltips
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Older releases are not translated yet. If you can, please edit this page to add them from the Japanese changelog on [GitHub](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md).
|
||||
:::
|
||||
@ -3,7 +3,7 @@ In Misskey, it's possible to individually deactivate the LTL/STL/GTL.You can ena
|
||||
|
||||
As all posts across your instance can be seen in both the LTL and STL, they have the advantage of making it easy for new users to find others that they are interested in without having to use the manual user search. At the same time however, this means that following other users to see their posts is less important and inappropriate posts may be shown to users more frequently. Additionally, the experience becomes more alike that of a Chatroom, which in turn may make it more difficult for new users to join in one conversations with those who have been taking part for a long time. As the weight of these advantages and disadvantages may vary from server to server, the choice of using or not using them has been left to each individual instance. If you feel like the demerits outweigh the merits, please consider deactivating these respective timelines.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Disabling timelines can lead to confusion and possibly to a short-time drop in users.Therefore, please carefully consider the effects of disabling a timeline, and explain the reasoning for doing so in advance, so that your users can prepare by e.g. following users they often talk with on the LTL/STL.
|
||||
:::
|
||||
|
||||
@ -3,7 +3,7 @@ description: 'If you run into a problem, please check this page first.'
|
||||
---
|
||||
|
||||
# Troubleshooting
|
||||
::: tip
|
||||
:::tip
|
||||
Please also use the [Frequently asked questions](./faq.md) page.
|
||||
:::
|
||||
|
||||
@ -32,7 +32,7 @@ Please try the following:
|
||||
## Parts of the UI are weird (For example, the background is transparent)
|
||||
Broken UI display may be caused by the theme cache system when the UI is changed as part of an update. Pressing "Clear cache" in the settings will fix this.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Specifically clear the "Client's" cache. Don't clear the "Browser's" cache.
|
||||
:::
|
||||
|
||||
@ -1,85 +0,0 @@
|
||||
---
|
||||
layout: Landing
|
||||
|
||||
description: "Misskey is an open source, decentralized social media platform that's free forever!"
|
||||
gettingStarted: "Get started!"
|
||||
learnMore: "Learn more"
|
||||
keyFeatures:
|
||||
open:
|
||||
title: "Open"
|
||||
description: "Misskey is open source software that anyone can contribute to and everyone can use for free whenever and wherever."
|
||||
federated:
|
||||
title: "Federated"
|
||||
description: "Misskey is a decentralized platform, so communities on different instances can connect with each other."
|
||||
multifunction:
|
||||
title: "Powerful"
|
||||
description: "Misskey is both easy to understand for beginners and has powerful features for advanced users."
|
||||
customizable:
|
||||
title: "Customizable"
|
||||
description: "Make Misskey yours! With themes, widgets, layouts, and more, you make make Misskey just the way you like it."
|
||||
sections:
|
||||
federatedSoftware:
|
||||
title: "Misskey is a <b data-marker>decentralized</b> platform."
|
||||
description: "Misskey is just a platform for server owners to make their own instances of Misskey, and they can all talk to each other! There's large instances for the masses, smaller ones for groups, fandoms, and subcultures, and even instances just for individuals and their friends. Want to have even more control? You can make your own instance on your server with relative ease, cutting ties from any large company who wants to spy on you and sell your data. Misskey is about community and sharing, not corporations and big tech. Have friends not on Misskey? No problem! Because Misskey is on the Fediverse (ActivityPub), you can interact with people on other platforms like Mastodon, PixelFed, PeerTube, and more!"
|
||||
features:
|
||||
title: "Features"
|
||||
description: "Misskey has a wide variety of unique features!"
|
||||
list:
|
||||
note:
|
||||
title: "Note"
|
||||
description: "On Misskey, posts from users are called \"notes\". Reply, quote, add custom emojis, animated text, content warnings, attach multiple images, videos, GIFs, audio clips, or anything else!"
|
||||
reaction:
|
||||
title: "Reactions"
|
||||
description: "You can add emoji reactions to any post! No longer are you bound by a like button, show everyone exactly how you feel with the tap of a button."
|
||||
theme:
|
||||
title: "Theme"
|
||||
description: "Why be limited by just a Light or Dark theme when you can change all the colors? Use Misskey's intuitive theming functions to make Misskey just how you like it."
|
||||
charts:
|
||||
title: "Charts"
|
||||
description: "For those who need to see everything, Misskey has powerful charts for both users and admins to see what exactly is going on in your instance in real time."
|
||||
federation:
|
||||
title: "Federation"
|
||||
description: "Not on Misskey? No problem! Not only can Misskey instances talk to each other, but you can make friends with people on other networks like Mastodon and Pixelfed!"
|
||||
drive:
|
||||
title: "Drive"
|
||||
description: "Hate not being able to find something you uploaded? With Drive, you get managed and powerful cloud storage right in your social media!"
|
||||
thread:
|
||||
title: "Threads"
|
||||
description: "Have a lot on your mind? Make a thread! Each post can have up to 3,000 characters by default, and you can keep the conversation going for hours."
|
||||
widgets:
|
||||
title: "Widgets"
|
||||
description: "Have everything at your fingertips with over a dozen customizable widgets!"
|
||||
gettingStarted:
|
||||
title: "Join Misskey today!"
|
||||
find:
|
||||
title: "Find an instance!"
|
||||
list: "List of instances"
|
||||
create:
|
||||
title: "Make your own instance"
|
||||
guide: "Setup guide"
|
||||
docs:
|
||||
title: "Learn more"
|
||||
docs: "See docs"
|
||||
donation:
|
||||
title: "Donation"
|
||||
description: "Because Misskey is a non-profit, we rely on your donations to fund our development. If you like Misskey, please consider donating so that we can continue to make Misskey awesome for years to come!"
|
||||
sponsors:
|
||||
title: "Sponsors"
|
||||
---
|
||||
|
||||
<!--
|
||||
<style>
|
||||
.ai {
|
||||
display: none;
|
||||
}
|
||||
.screenshot.desktop {
|
||||
content: url("/screenshot-desktop-en.png");
|
||||
}
|
||||
.screenshot.mobile {
|
||||
content: url("/screenshot-mobile-en.png");
|
||||
}
|
||||
.widgets {
|
||||
content: url("/top-features-widgets-en.png");
|
||||
}
|
||||
</style>
|
||||
-->
|
||||
@ -1,51 +0,0 @@
|
||||
---
|
||||
description: 'collection of Misskey logos, icons, and other assets.'
|
||||
---
|
||||
|
||||
# Assets collection
|
||||
This is a collection of Misskey logos, icons, and other assets.
|
||||
|
||||
|
||||
::: tip
|
||||
These assets are free to use under the **CC BY-NC-SA** license!🎉
|
||||
|
||||
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="CC BY-NC-SA" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a>
|
||||
:::
|
||||
|
||||
::: tip
|
||||
All assets are managed in [misskey-dev/assets](https://github.com/misskey-dev/assets).
|
||||
:::
|
||||
|
||||
## Logo
|
||||
<a class="asset" href="https://raw.githubusercontent.com/misskey-dev/assets/main/misskey.svg" target="_blank" download>
|
||||
<img src="https://raw.githubusercontent.com/misskey-dev/assets/main/misskey.svg">
|
||||
</a>
|
||||
|
||||
## Icon
|
||||
<a class="asset" href="https://raw.githubusercontent.com/misskey-dev/assets/main/icon.png" target="_blank" download>
|
||||
<img src="https://raw.githubusercontent.com/misskey-dev/assets/main/icon.png">
|
||||
</a>
|
||||
|
||||
<style>
|
||||
.asset {
|
||||
display: block;
|
||||
background-color: #777;
|
||||
background-image:
|
||||
linear-gradient(45deg, #999 25%, transparent 25%),
|
||||
linear-gradient(135deg, #999 25%, transparent 25%),
|
||||
linear-gradient(45deg, transparent 75%, #999 75%),
|
||||
linear-gradient(135deg, transparent 75%, #999 75%);
|
||||
background-size: 25px 25px; /* Must be a square */
|
||||
background-position: 0 0, 12.5px 0, 12.5px -12.5px, 0px 12.5px; /* Must be half of one side of the square */
|
||||
animation: asset-bg 0.5s linear infinite;
|
||||
|
||||
margin: 1em 0;
|
||||
padding: 16px;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
@keyframes asset-bg {
|
||||
0% {background-position: 0 0, 12.5px 0, 12.5px -12.5px, 0px 12.5px;}
|
||||
100% {background-position: 12.5px 12.5px, 25px 12.5px, 25px 0px, 12.5px 25px;}
|
||||
}
|
||||
</style>
|
||||
@ -1,3 +0,0 @@
|
||||
# Help
|
||||
|
||||
- [List of functions](./docs/features/index.md)
|
||||
@ -1,60 +0,0 @@
|
||||
---
|
||||
home: true
|
||||
title: Misskey Hub
|
||||
heroImage: /banner.svg
|
||||
tagline: Official web site of open-source interplanetary micro-blogging platform Misskey
|
||||
footer: Copyright © 2023 syuilo and other contributors
|
||||
actions:
|
||||
- text: Getting started
|
||||
link: ./docs/getting-started
|
||||
type: primary
|
||||
- text: What is Misskey?
|
||||
link: ./docs/misskey
|
||||
type: secondary
|
||||
features:
|
||||
- title: Distributed 🪐
|
||||
details: Independent communities are run on multiple servers, and these are interconnected.
|
||||
- title: Lightweight 🚀
|
||||
details: Because it uses Node.js, which runs at high speed, it is lightweight even when federated with a large number of servers.
|
||||
- title: Fun 🍮
|
||||
details: It has distinctive features such as reactions and a highly customizable UI.
|
||||
---
|
||||
|
||||
<ClientOnly>
|
||||
<MkParticles/>
|
||||
</ClientOnly>
|
||||
|
||||
<div class="contents">
|
||||
|
||||
# Sponsors
|
||||
<div class="sponsors">
|
||||
<a class="rss3" title="RSS3" href="https://rss3.io/" target="_blank"><img src="/sponsors/rss3.svg" alt="RSS3"></a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<style>
|
||||
.hero {
|
||||
position: relative;
|
||||
z-index: 2;
|
||||
}
|
||||
|
||||
.contents {
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.sponsors {
|
||||
text-align: center;
|
||||
margin-bottom: 32px;
|
||||
}
|
||||
|
||||
.sponsors > .rss3 {
|
||||
display: inline-block;
|
||||
padding: 0px 20px;
|
||||
background: #fff;
|
||||
border: solid 1px #000;
|
||||
}
|
||||
.sponsors > .rss3 img {
|
||||
display: inline-block;
|
||||
height: 120px;
|
||||
}
|
||||
</style>
|
||||
@ -1,17 +0,0 @@
|
||||
# List of instances
|
||||
::: tip
|
||||
If you would like to list your instance here, please feel free to contact us via [Discord](https://discord.gg/Wp8gVStHW3) or make a pull request on this site's [GitHub](https://github.com/misskey-dev/misskey-hub).
|
||||
:::
|
||||
|
||||
<MkInstances/>
|
||||
|
||||
Alternatively, you can find an instance from the [unofficial list of instances](https://join.misskey.page/en-US/instances).
|
||||
|
||||
<style>
|
||||
.mkAd {
|
||||
display: none !important;
|
||||
}
|
||||
.aiModeButton {
|
||||
display: none;
|
||||
}
|
||||
</style>
|
||||
@ -1,12 +0,0 @@
|
||||
# Plugin Store
|
||||
A collection of [plugins](./docs/features/plugin.md) that you can install in the Misskey web UI.
|
||||
|
||||
::: tip
|
||||
If you would like to see your plugin here, please see [the section on submitting plugins](#Submitting-Plugins).
|
||||
:::
|
||||
|
||||
## Plugins
|
||||
- TODO
|
||||
|
||||
## Submitting Plugins
|
||||
TODO
|
||||
@ -1,3 +0,0 @@
|
||||
# Recent changes
|
||||
|
||||
<!--[RECENT_UPDATES]-->
|
||||
@ -12,6 +12,6 @@ L’API Misskey ne peut pas être mise en cache.
|
||||
Vous devez configurer l’option suivante dans votre CDN :
|
||||
- Mettre en cache toutes les requêtes sauf `/api/*`.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Pas besoin de vider le cache lorsque vous mettez à jour Misskey.
|
||||
::::
|
||||
@ -20,7 +20,7 @@ Si vous disposez d’une image que vous souhaiter utiliser, celle-ci peut être
|
||||
Cela fonctionne comme en joignant des fichiers à une note :
|
||||
Vous pouvez choisir de téléverser un nouveau fichier, et le sélectionner depuis votre Drive Misskey ou une URL distante.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
En important une émoticône sur votre Drive, le fichier y restera.
|
||||
Misskey ne fait pas de copies de ce fichier et si vous le supprimez celui-ci sera cassé.
|
||||
:::
|
||||
@ -32,7 +32,7 @@ L’émoticône sera ajoutée à l’instance et vous pourez la modifier ou supp
|
||||
Les émoticônes peuvent être importées en masse à partir d’un format spécial au sein d’une archive ZIP.
|
||||
Cette fonction est disponible dans le menu du coin supérieur droit de l’onglet d’émoticônes personnalisées.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
L’import en masse peut écraser les émoticônes existant et créer de nombreux problèmes sur l’instance.
|
||||
Assurez vous de n’importer que depuis des sources de confiance, voire que vous aurez-vous même exporté dans l’idéal.
|
||||
:::
|
||||
@ -88,7 +88,7 @@ Seul les suivants sont utilisés :
|
||||
Les propriétés d’une émoticône peuvent être modifiése en la sélectionnant dans la liste locale.
|
||||
Un menu permet de la modifier ou supprimer.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
En supprimant une émoticône personnalisées, les anciennes notes seront modifiées.
|
||||
:::
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
# Comment utiliser GitHub Actions pour pousser vers un Docker Hub
|
||||
::: warning
|
||||
:::warning
|
||||
Cette page n’est pas encore traduite. Le contenu est disponible en [japonais exclusivement](/docs/admin/push-docker-hub.md).
|
||||
|
||||
En attendant, essayez d’utiliser un traducteur automatique.
|
||||
@ -1,5 +1,5 @@
|
||||
# Guide de dépannage
|
||||
::: warning
|
||||
:::warning
|
||||
Cette page n’est pas encore traduite. Vous trouverez le contenu dans la version [japonaise exclusivement](/docs/admin/troubleshooting.html).
|
||||
|
||||
En attendant, veuillez utiliser un traducteur automatique.
|
||||
@ -6,7 +6,7 @@ description: 'Misskey offre une API pour développer son propre client Misskey,
|
||||
Misskey dispose d’une APi pour développer son propre client Misskey, des services liés, des bots, etc… (« Applications »).
|
||||
Il existe également un flux API pour créer des applications avec des fonctions en temps réel.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
En utilisant le SDK officiel Misskey ou une librairie tierce, vous pouvez utiliser l’API de manière à simplifier des étapes décrites dans ce document.
|
||||
Voir [ici](TODO) pour plus d’informations à propos des librairies.
|
||||
:::
|
||||
@ -18,7 +18,7 @@ Ce document vous accompagne dans l’obtention de cette clé et montre comment l
|
||||
L’API requiert une clé d’accès pour ses requêtes.
|
||||
Une clé d’accès est un ensemble de données associée à une personne, l’identifiant comme utilisant l’API et contrôlant les opérations qui sont effectuées.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
La clé est nominative et ne peut être utilisée que par une personne, plusieurs clés peuvent être possédées par une personne.
|
||||
:::
|
||||
|
||||
@ -27,14 +27,14 @@ Vous pouvez facilement [obtenir votre clé d’accès](#Méthode-manuelle), ou u
|
||||
### Méthode manuelle
|
||||
Vous pouvez créer votre propre clé d’accès via l’interface Misskey Web dans la section API des paramètres.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Ne communiquez pas cette clé.
|
||||
:::
|
||||
|
||||
### Demander une clé d’accès
|
||||
Pour obtenir une clé d’accès pour une personne utilisant votre application, suivre les étapes suivantes :
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
|
||||
|
||||
[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app)
|
||||
@ -43,7 +43,7 @@ Pour obtenir une clé d’accès pour une personne utilisant votre application,
|
||||
#### Étape 1
|
||||
Générer un UUID, ci-après dénommé **ID session**.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Cet ID session est à usage unique.
|
||||
:::
|
||||
|
||||
@ -91,7 +91,7 @@ Les propriétés incluses dans la réponse sont les suivantes :
|
||||
## Utilisation de l’API
|
||||
Une fois la clé en main, vous pouvez utiliser l’API pour faire des requêtes.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
- Toutes les API HTTP sont POST, et les requête comme les réponses sont au format JSON (à l’exception de drive/files/create ;
|
||||
- Indiquez `Content-Type: application/json` dans l’entête de requête ;
|
||||
- La clé d’accès est dans le corps de requête JSON avec comme valeur de name `i`.
|
||||
@ -110,12 +110,12 @@ La clé d’accès est incluse dans le corps de requête JSON comme paramètre `
|
||||
|
||||
Pour plus d’informations à propos de l’API voir [référence API](./endpoints.html).
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Misskey n’utilise pas REST.
|
||||
:::
|
||||
|
||||
En plus de l’API HTTP, Misskey fourni un flux API. Plus d’informations à ce sujet [ici](.streaming/).
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Votre instance Misskey dispose de sa propre documentation d’API à `/api-doc`.
|
||||
:::
|
||||
@ -4,7 +4,7 @@ description: 'L’API de flux fournit des informations en temps réel (ex : nou
|
||||
|
||||
# API de flux
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Assurez-vous d’avoir lu la [documention API Misskey](../index.md) au préalable.
|
||||
:::
|
||||
|
||||
@ -24,7 +24,7 @@ où
|
||||
- `{host}` est le nom de l’hôte de l’instance ;
|
||||
- `{token}` est la clé d’accès.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Vous pouvez vous connecter sans clé d’accès, mais cela limitera les informations reçues et les opérations possibles.
|
||||
:::
|
||||
|
||||
@ -38,7 +38,7 @@ Pour recevoir ces évènements, vous devez rejoindre un **canal** sur le flux, t
|
||||
L’API de flux Misskey utilise un concept de canaux. Ce mécanisme sépare les informations reçus et envoyées.
|
||||
En rejoignant des canux, vous aurez la possibilité de recevoir et envoyer de nombreuses informations.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Vous pouvez rejoindre plusieurs canaux simultanément via un flux unique.
|
||||
:::
|
||||
|
||||
@ -65,7 +65,7 @@ où
|
||||
- `id` est un identifiant arbitraire pour interragir avec ce canal. Il est nécessaire pour identifier de quel canal le message provient, un flux pouvant contenir différent canaux. Cet identifiant peut être un UUID ou un nombre aléatoire ;
|
||||
- `params` sont les paramètres requis pour rejoindre un canal. Chaque canal requiert des paramètres propres. Si un canal n’en demande pas, alors cette propriété peut être laissée vide.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
L’identifiant n’est pas unique par canal mais par connexion car un canal peut être utilisé plusieurs fois avec différents paramètres.
|
||||
:::
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
Misskey peut afficher des publicités dans les fils et d’autres emplacements de l’interface si activé par l’administration.
|
||||
Vous pouvez réduire la fréquence d’apparition d’une publicité en cliquant dans son coin supérieur droit.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Si le nombre total de publicités d’une instance est limité, une publicité peut apparaître souvent même si vous choisissez de réduire sa fréquence d’apparition.
|
||||
:::
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
Drive est une fonction permettant de gérer vos fichiers sur Misskey.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Techniquement, Drive est une interface centrale pour gérer tout le système Misskey qui est également disponible aux membres.
|
||||
:::
|
||||
|
||||
@ -12,7 +12,7 @@ Les fichiers téléversés sur Drive peuvent être téléchargés à tout moment
|
||||
|
||||
Vous pouvez également créer des dossiers sur votre Drive pour rassembler des fichiers ensemble.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Pour le moment, la suppression d’un fichier sur le drive entraîne la suppression de **tout contenu (note, pages, etc…)** rattaché.
|
||||
:::
|
||||
|
||||
@ -5,7 +5,7 @@ description: 'MFM est un langage de balise spécifique à Misskey.'
|
||||
# MFM
|
||||
MFM, abréviation de Misskey Flavoured Markdown, est un langage de balise spécifique à Misskey.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Une partie de la syntaxe est compatible avec Markdown.
|
||||
:::
|
||||
|
||||
@ -17,7 +17,7 @@ Une partie de la syntaxe est compatible avec Markdown.
|
||||
|
||||
## Syntaxe
|
||||
### Mentions
|
||||
::: tip
|
||||
:::tip
|
||||
Pour plus d’informations sur les mentions, voir [ici](./mention.md).
|
||||
:::
|
||||
|
||||
@ -30,7 +30,7 @@ Pour plus d’informations sur les mentions, voir [ici](./mention.md).
|
||||
|
||||
### Mot-croisillon
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Pour plus d’informations sur les mots-croisillons, voir [ici](./hashtag).
|
||||
:::
|
||||
|
||||
@ -40,7 +40,7 @@ Pour plus d’informations sur les mots-croisillons, voir [ici](./hashtag).
|
||||
|
||||
### Émoticône personnalisé
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Pour plus d’informations sur les émoticônes personnalisés, voir [ici](./custom-emoji).
|
||||
:::
|
||||
|
||||
@ -62,7 +62,7 @@ Pour plus d’informations sur les émoticônes personnalisés, voir [ici](./cus
|
||||
|
||||
---
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Plus de détails sur la syntaxe sont disponibles sur le **pense-bête MFM** de l’interface web Misskey sur la page `/mfm-cheat-sheet` de votre instance.
|
||||
:::
|
||||
|
||||
@ -4,11 +4,11 @@ Si une personne ne vous plaît pas, il vous est possible de l’ignorer de sorte
|
||||
Autrement, il est possible de bloquer une personne pour l’empêcher de voir votre activité et d’interagir de quelque façon que ce soit.
|
||||
Les personnes ne sont pas notifiée que vous les ignorez mais sauront si vous les avez bloqué. À vous de décider quelle option vous préférez.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Ignorer et bloquer peuvent être utilisés ensemble.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Pensez à signaler à la modération toute personne qui violerait les conditions générales d’utilisation.
|
||||
:::
|
||||
|
||||
@ -24,7 +24,7 @@ En ignorant une personne, n’apparaîtront plus sur Misskey :
|
||||
|
||||
Pour l’ignorer, ouvrez le menu sur son profil et cliquez sur le bouton « Ignorer ».
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Ces personnes ne sauront pas que vous les ignorez.
|
||||
:::
|
||||
|
||||
@ -45,11 +45,11 @@ De plus ;
|
||||
|
||||
Pour bloquer une personne, ouvrez le menu sur son profil et cliquez sur le bouton « Bloquer ».
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Vous ne recevrez pas de notification si une personne vous bloque, vous le saurez indirectement en étant incapable d’interagir avec son contenu.
|
||||
:::
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Une personne bloquée pourra tout de même voir votre contenu en se déconnectant ou changeant de compte. Bloquer est une fonction simple mais pratique.
|
||||
Vous pouvez modifier vos paramètres de manière à rendre la tâche plus difficile aux personnes bloquées en demandant systématiquement votre autorisation pour vous suivre et en limitant votre visibilité auxpersonnes qui vous suivent.
|
||||
:::
|
||||
@ -12,11 +12,11 @@ Ajouter une note à vos [favoris](./favorite) vous permet de la retrouver facile
|
||||
|
||||
Pour composer une note, cliquez sur l’un des boutons avec une icône de crayon de votre écran pour ovurir l’onglet (en tête de votre fil ou en pied de votre menu de navigation). Insérez le contenu souhaité et cliquez sur « Noter » pour la publier. Les notes peuvent contenir du texte, des fichiers multimédias, et des [sondages](./poll). De plus, vous pouvez utiliser le [MFM](./mfm) au sein de votre texte pour inclure des [mentions](./mention) et des [mots-croisillons](./hashtag). D’autres options comme l’avertissement de contenu (CW) ou la visibilité de note sont expliquées plus bas.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Si vous êtes sur un ordinateur et qu’une image est dans votre presse-papier, vous pouvez l’insérer dans une note avec le raccourci usuel au sein du champ de texte.
|
||||
:::
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Vous pouvez également utiliser <kbd class="key">Ctrl + Entrée</kbd> dans le champ de texte pour publier la note.
|
||||
:::
|
||||
|
||||
@ -24,7 +24,7 @@ Vous pouvez également utiliser <kbd class="key">Ctrl + Entrée</kbd> dans le ch
|
||||
|
||||
Désigne l’action de citer ou partager une note existante. La note résultante est appelée une Renote/RN du verbe renoter. Généralement, cette fonction est utilisée pour partager une note qui vous plait à votre propre cercle, ou pour republier une de vos anciennes notes. Bien que possible, renoter plusieurs fois la même note peut être mal vu.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Si la visibilité de votre note est limitée à Directe ou aux personnes qui vous suivent, il ne sera pas possible de la renoter.
|
||||
:::
|
||||
|
||||
@ -42,7 +42,7 @@ Il est possible de régler la visibilité de chaque note. En cliquant sur l’ic
|
||||
|
||||
Votre note sera visible pour tout le monde et sera affichée dans tous les fils.
|
||||
|
||||
::: warning
|
||||
:::warning
|
||||
Cette option n’est pas disponible si votre compte est <a href="./silence">limité</a>.
|
||||
:::
|
||||
|
||||
@ -74,7 +74,7 @@ Cette option permet à votre note de pas apparaître sur d’autres instances.
|
||||
|
||||
En épinglant une note à votre profil, celle-ci sera constamment affichée en en-tête. Pour l’épingler, sélectionnez l’option dans le menu d’une note.
|
||||
|
||||
::: tip
|
||||
:::tip
|
||||
Il est possible d’épingler plusieurs notes à son profil.
|
||||
:::
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user