xrpl-dev-portal/content/resources/contribute-documentation/contribute-documentation.ja.md

html, parent, blurb

html	parent	blurb
contribute-documentation.html	resources.html	XRP Ledgerドキュメントのコントリビューションガイドです。

ドキュメントへの貢献

XRP Ledger開発者ポータルへの貢献を検討いただきありがとうございます！

私たちは、あなたが興味を持ってくださっていることにとても感動しています。XRP Ledger(XRPL)へ貢献することは、XRPLついて学ぶ素晴らしい機会です。

私たちはあなたのプルリクエストを喜んでレビューします。プロセスをできるだけ円滑に進めるため、このドキュメントを読み、記載されているガイドラインに従ってください。

当サイトについて

XRPL Dev Portalでは、開発者が開発を開始するためのサンプルコードやその他の情報を含む、XRP Ledgerの包括的なドキュメントを提供しています。

本プロジェクトの公式リポジトリはhttps://github.com/XRPLF/xrpl-dev-portalとなっています。投稿の著作権はそれぞれの投稿者に帰属しますが、MITライセンスの下で提供されなければなりません。

リポジトリの構成

• assets/ - サイトのテンプレートで使用される静的ファイル。
• content/ - ドキュメントを構築するために使用されるソースファイル。ほとんどがMarkdownです。
  • content/_code-samples/ - ドキュメントで使用または参照されているコードサンプル。可能な限り、これらは完全に機能する/実行可能なスクリプトです。
  • content/_img-sources/ - ドキュメントで使用されている画像の元ファイル。.uxfファイルはUmletで作成されたダイアグラムです。
  • content/_snippets/ - Dactylプリプロセッサを使用して、他のコンテンツファイルに挿入される再利用可能なMarkdownテキストの断片。
• img/ - ドキュメントコンテンツで使用される画像。
• template/ - HTMLを構築するためのテンプレートファイル。
• tool/ - フィルター、スタイルチェッカー・ルール等のスクリプト。
• styles/ - assetsフォルダにCSSファイルを生成するための元ファイル(SCSS)。
• dactyl-config.yml - サイトのメタデータを含むメイン設定ファイル。設定ファイルのフォーマットについては、設定フォーマットを参照してください。

プルリクエストが承認されるための条件

レビューやマージが承認される前に、それぞれのプルリクエストは以下の条件を満たしていなければなりません。

• インテグレーションテストに合格すること。
• レビューの準備が整うまで、Draftとしてください。
• このリポジトリのコード規約を遵守してください。

Dactylのセットアップ

ポータルはDactylを使用して構築されています。

DactylにはPython 3が必要です。pipを使ってインストールしてください：

pip3 install dactyl

サイトの構築

このリポジトリでは、Dactylを使用して、すべてのドキュメントのHTMLをビルドしています。Dactylのセットアップを行った後、プロジェクトのルートディレクトリからサイトをビルドすることができます。

dactyl_build

生成されたコンテンツはout/ディレクトリに出力されます。これらのコンテンツはウェブブラウザでファイルとして開いたり、ウェブサーバで静的コンテンツとして扱うことができます。

ルートディレクトリからリンクチェックやスタイルチェックを実行することもできます。

リンクチェックは出力フォルダを空にしてからビルドしてください。

dactyl_link_checker

スタイルチェックは実験的なものです。

dactyl_style_checker

設定ファイルのフォーマット

このリポジトリでは、dactyl-config.ymlファイルのメタデータとページのfrontmatterを使って、ヘッダー、フッター、サイドバー、パンくずリストなどのナビゲーション要素を生成します。

新しいページを追加する場合、dactyl-config.ymlファイルのpages配列の適切な位置に追加する必要があります。追加例は次のようになります。

    -   md: concepts/the-rippled-server/the-rippled-server.md
        targets:
            - en
            - ja # 翻訳コンテンツがない場合、全てのターゲットを対象とします。

Markdownファイル自体は、以下のようなfrontmatterで始まる必要があります。

---
html: the-rippled-server.html
parent: concepts.html
template: pagetype-category.html.jinja
blurb: rippled is the core peer-to-peer server that manages the XRP Ledger. This section covers concepts that help you learn the "what" and "why" behind fundamental aspects of the rippled server.
---

少なくとも、ほとんどのページには html、parent、blurb フィールドが必要です(さらに、設定ファイルではmdフィールドとtargetsフィールドも必要です)。ここに、またはページの設定ファイルのエントリに任意のキーと値のペアを記述することができますが、以下のものが関係しています。

規約

ページを作成する際には、以下の規約に従ってください。

• HTMLのファイル名とMDのファイル名は、拡張子を除いて完全に一致していなければなりません。

• ファイル名は"and"や"the"のような単語を含め、ページのタイトルと密接に一致する必要がありますが、スペースや句読点の代わりにハイフンを使用し、すべて小文字にする必要があります。例えば、cash-a-check-for-an-exact-amount.mdのようにします。ページのタイトルを変更した場合は、ファイル名も変更する必要があります。(すでに別のURLで公開されている場合は、古いURLからのリダイレクトを残してください)

• 常にh1ヘッダーでページを始めます。

• ページの一番上のh1アンカーにはリンクせず、アンカーなしでページ自体にリンクしてください。これは翻訳時のリンク切れを防ぐのに役立ちます。以降のヘッダーへのリンクは問題ありません。

• ページのタイトルに書式( italics やcode fontなど)を使わないでください。

• Markdownファイルのテキストを折り返さないでください。

• コードサンプルの場合、行は80文字以下になるようにしてください。

• 迷ったら、Ciro SantilliのMarkdownスタイルガイド (Writability Profile)に従ってください。

• ランディングページはサブフォルダに入れ、フォルダと同じファイル名とします。例えば、"Accounts"ページグループのランディングページはaccounts/accounts.mdで、HTMLファイル名はaccounts.htmlです。

  注意: index.mdは利用しないでください。

• Markdownやコードサンプルでは、インデントにタブ文字を使用しないでください。JavaScriptのコードサンプルでは、1字下げにつき2個のスペースを使用してください。

技術用語

以下の単語やフレーズを説明通りに使用してください。

用語	避けるべき用語	備考
API, APIs	API's, RPC	Application Programming Interface (アプリケーション・プログラミング・インターフェース)、ソフトウェアが他のソフトウェアと接続するための機能と定義のセット。
コアサーバ, XRP Ledgerのコアサーバ	rippled	rippledという名前は近い将来廃止される可能性が高いので、より一般的な名前で呼ぶことを推奨します。必要なときは、rippled をすべて小文字で、コードフォントで呼んでください。(発音は "リップルディー" で、"d" は UNIX の伝統に従って"daemon"を意味します)。
金融機関	銀行, FI, PSP (決済サービスプロバイダ)	この用語は、銀行 や他の用語よりも幅広いビジネスを包含し、業界の専門用語の理解に依存しません。
レジャーエントリ	レジャーオブジェクト, ノード	XRP Ledgerの状態データ内の単一のオブジェクト。レジャーオブジェクト という用語は、これらの一つを指すこともあれば、レジャー全体を指すこともあります。レジャーの状態データはグラフとして想定できるため、ノード という用語が使われることもありましたが、ノード には他の用途もあるため、混乱を招きます。
流動性提供者	マーケットメイカー	2つの通貨または資産間の売買を提供し、多くの場合、取引間の価格差から利益を得る企業または個人。マーケットメーカーという用語は、法域によっては特定の法律上の定義があり、すべての同じ状況で適用されるとは限りません。
悪質業者	ハッカー	個人、組織、または自動化されたツールなどによる、機密情報の取得、暗号化の解除、サービスの拒否、その他の安全なリソースへの攻撃を試みる可能性のあるもの。
PostgreSQL	Postgres	リレーショナルデータベース・ソフトウェアの特定のブランド。非公式な短いバージョンではなく、常に完全な名前を使用します。
オーダーブック	オファーブック	マッチングされ約定されるのを待っているトレード注文のコレクション。通常は取引レートごとにソートされています。
サーバ	ノード	サーバとは、ソフトウェアやハードウェアのことで、特にXRP Ledgerのピアツーピアネットワークに接続するものを指します。ノード という用語はこの目的のために使われることもありますが、グラフのエントリやJavaScriptインタプリタであるNode.jsなど、他の意味でも多用されます。
ステーブルコイン発行者	ゲートウェイ	発行者とは、XRP Ledgerにおいてトークンを発行する組織です。ステーブルコインとは、発行者が外部の資産（例えば不換紙幣）に完全に裏付けられていることを約束しているトークンのことで、ステーブルコインの発行者は、その2つの資産を（場合によっては手数料を払って）交換する入出金操作を提供します。以前は、このユースケースを表現するために（特にリップル社によって）ゲートウェイ という用語が使用されていましたが、業界の他の部分は代わりに ステーブルコイン発行者 を採用しました。
トランザクションコスト	トランザクション手数料	XRP Ledgerでトランザクションを送信するために消費されるXRPの金額。これはトランザクションのFeeフィールドで指定されますが、手数料 という用語は誰かにお金を支払うことを意味するため、コスト の方が望ましいです。
トークン	IOU, issuances, issues, 発行済み通貨	XRP Ledgerのトークンは、IOU という名前から想像されるように、レジャーの外部にある価値を表すことはできません。必要であれば、代替可能トークン を使用して、非代替性トークン(NFT)と区別してください。
ウォレット	ウォレット	文脈によっては、ウォレット はハードウェア、ソフトウェア、暗号鍵ペア、またはオンラインサービスを指します。意味が明確になるように十分な文脈を提供するか、キーペア や クライアントアプリケーション などの別の表現を使用してください。
XRP	Ripple, リップル	XRPレジャーのネイティブデジタルアセットまたは暗号通貨。XRPはレジャーの外部の価値を表すトークンではありません。
XRP Ledger	Ripple, リップル, Ripple Network, リップルネットワーク, RCL	XRP Ledgerは、過去に様々な場面で「リップルネットワーク」や「リップルコンセンサスレジャー」あるいは「RCL」と呼ばれていました。これらの名称は、コアサーバーのリファレンス実装を開発しているRipple(Ripple Labs)の社名と類似しているため、紛らわしく、廃止されました。
XRPL	XRPL	XRP Ledger の略です。XRPL は不明瞭で、XRP のタイプミスのように見えることがあります。

Frontmatterのフィールド

このリポジトリのMarkdownファイルのfronmatterは任意のキーと値のペアを含むことができます。以下のフィールドは特定の用途や意味を持ちます。

フィールド	型	内容
html	String	ページの出力ファイル名。.htmlで終わり、ターゲット内で一意でなければなりません。翻訳版のページでは、ファイル名は英語版のページと同じにしてください。
parent	String	ページの「親」ページのhtmlの値。このページがナビゲーションのどこに表示されるかを示します。
blurb	String	ページの要約文(プレーンテキストのみ)。ランディングページやソーシャルメディア上でリンクを展開する際のメタデータなど、さまざまな場所に表示されます。
name	String	ページ名(プレーンテキストのみ)。 Markdownコンテンツのあるファイルでは、Dactylがコンテンツの最初の行のヘッダーから自動的に検出できるため、これを省略する必要があります。これは通常、Markdownファイルを持たないランディングページやその他の特別なページでのみ提供されます。
template	String	このページで使用するテンプレートファイルのファイル名(template/ディレクトリ内)。ほとんどのページはデフォルトのテンプレートを使用します。pagetype-category.html.jinjaテンプレートは最後に子ページのリストを表示します。特別な、あるいは特にユニークなレイアウトを持つページには、個別のテンプレートが必要になることがあります(通常、page-で始まります)。
status	String	XRP Ledgerメインネットでまだ有効になっていない修正に関連するページでは、not_enabledを使用します。これにより、ナビゲーションのページの横にツールチップ付きの"フラスコ"バッジが表示されます。
nav_omit	Boolean	ナビゲーション要素にこのページを表示しないようにするにはtrueを使用します。
top_nav_omit	Boolean	ページトップのドロップダウンナビゲーションに表示しないようにするには、trueを使用します。
top_nav_level	Number	トップナビのドロップダウンでページのインデントレベルを調整します。レベル2は、ドロップダウン内でその上のページの子のように表示されるようにインデントされます。
sidebar	String	U左右のサイドバーを非表示にするには、disabledを使用します(ページがベーステンプレートから派生したテンプレートを使用している場合)。
fb_card	String	Facebookでこのページへのリンクを展開する際に使用する画像のファイル名（assets/img/内）。
twitter_card	String	Twitterでこのページへのリンクを展開する際に使用する画像のファイル名（assets/img/内）。
redirect_url	String	template: pagetype-redirect.html.jinjaでのみ使用します。ユーザがこのページに移動したときに、指定されたURLに自動的にリダイレクトします。
cta_text	String	このページにリンクする「call to action」ボタンに表示されるテキスト(特別なランディングページにて表示されます)。
curated_anchors	Array of Objects	子ページと同様に、ランディングページに表示するためのアンカーです。配列の各オブジェクトは、人間が読めるnameフィールド("Available Modes"など) と、リンク先のHTML IDを持つanchorフィールド("#available-modes"など)を持つ必要があります。
skip_spell_checker	Boolean	trueを使用すると、Dactylのスタイルチェッカーがこのページのスペルチェックをスキップします。
filters	Array of Strings	このページで使用する追加フィルタのリストです。フィルタはPythonスクリプトで、ページ内容の事前または事後の追加処理を行います。
canonical_url	String	クエリパラメータを受け取るページの正規URLを提供します。検索エンジンやその他のツールは、ページにリンクする際にこれを使用する可能性があります。
embed_xrpl_js	Boolean	最新版のxrpl.jsをこのページで読み込むにはtrueを使用してください。