Skip to content

Latest commit

 

History

History
96 lines (59 loc) · 3.75 KB

.README.md

File metadata and controls

96 lines (59 loc) · 3.75 KB

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/内にディレクトリ構造を作成中

新規に作成したページ

  • /2.for-users/2.onboarding/index.md 以外
  • /4.for-developers/play/ 以下
  • /4.for-developers/api/index.md を分割

APIリファレンスについて

API リファレンスは移動する予定です(misskey-jsから自動生成)

新しくDocsを作成するかたへ

Nuxtに変更したことに伴い、Canonical URLの統一のため、末尾にスラッシュが付くようになっています。

内部のリンクの切り分け処理が複雑になっているため、技術的なことがよくわかっていない場合や、自前でデバッグ環境を作成してリンクの検証ができない方は絶対パスを使うことをおすすめします。

VuePressでは末尾が.mdとなるパス形式でしたが、Misskey-Hub-Nextではコレは許容されません。実際のWebサイト上でのパスを入力してください。

ただし、リンクは自動的に言語ごとのものに変換されますので、マークダウン内で/ja/などの言語プレフィックスを付与しないようにしてください。

AiScriptハイライトについて

Misskey Hubでは、AiScriptのシンタックスハイライトに対応しています。言語識別子は、大文字小文字を区別し AiScript と正確に入力する必要があります。こちらのソースを参考にしてください。

独自コンポーネントについて

Nuxt Contentは、内部的にはmarkdownの拡張言語であるMDCを採用しています。

MDC記法でのVueコンポーネントの書き方は、こちらをご確認ください。 (特に、コンポーネントをネストする際の記法に気を付けてください)

【重要】コンポーネントブロックと他要素は1行開けてください

Crowdin側の仕様により、連続する行は同じ翻訳テキストとして認識されてしまいます。

コンポーネント記法を使う際は 前後に1行空けるようにしてください。

これは段落

:::tip

これはtipコンポーネントの中身(上下1行空ける!)

:::

これは次の段落

独自Frontmatterについて

date

(ブログのみ)公開時刻をオーバーライドできます。

date: 2023-11-11

thumbnail

(現状ブログのみ)サムネイル画像を設定できます。URLまたはサイトディレクトリの絶対パスを入力してください

thumbnail: /img/blog/foo/bar.png

maxTocDepth

(Docsのみ)もくじの見出しを遡る限度を指定できます。<h2>タグまでにしたい場合は2を指定します。

maxTocDepth: 2

ignoreDirBasedNav

(Docsのみ)true にすると、前へ・次へボタンを、前後のページの階層に関係なく表示します。

contact-faqについて

お問い合わせページに掲載するFAQが項目ごとに別ファイルとして格納されます。質問文はfrontmatterのquestionに、回答文はMarkdownの本文に記述してください。

---
question: "アカウントを削除してください(問いの部分)"
---

なんとかしてください(答えは残りのMarkdown部分)