Hoeppnerこれは私がユーザマニュアルを作成する際に進行中のリストです。私が表記規則を作り出した多くのものがあります。私はそれらを中央の空間に残して、他の人がそれらにアクセスできるようにし、それらを参照できるようにしたいのです。;-)リストは特定の順序に並んでいません。Sphinxをインストールする¶Maharaユーザマニュアルは、Sphinxがあなたのコンピュータにインストールされることを必要とします。見つけることができます。次の手順はDebianまたはUbuntuに基づくシステムに対するもので、あなたがターミナルで作業することを要求します。【訳注】CentOSに基づくシステムでもこの手順でよいです。texlive-fonts-extraまだ作成していない場合、あなたのコンピュータのリポジトリを置く場所にフォルダを作成します。html注釈これはユーザマニュアルで利用可能なすべての翻訳を作成し、少し時間がかかります。よって行うことができます。そのファイルを見い出すことができます。入力することであなたは仮想環境を非活性化できます。ユーザマニュアルを変更する¶いったんあなたがユーザマニュアルをあなたのコンピュータにインストールしたら、あなたは変更をすることができます。次の行動はターミナルで実行されます。venv/bin/activateあなたの好みのエディタで変更を行います。MAHARA=17.04注釈あなたがコンパイルしているMaharaのバージョンに応じてバージョン番号を変更します。指令を使用して配置されます。text)と図の説明を含みます。それは代替テキスと図の説明をテキストから分離します。それらがステップバイステップの指示の一部である場合、一般にリストの上に置かれます。それらに取り入れられるべきステップについてできるだけ少ないインストラクションを持つべきです。できれば、ステップ番号だけを交換することができ、ステップのテキストはテキストでありイメージの一部ではないため、翻訳可能です。それは、翻訳者がステップを翻訳できるけれども、直ちにスクリーンショットを変更する必要がないことも意味しています。図の一部を線で引き出して説明するテキスト)を得ます。見い出すことができます。アイテムが指摘されるが関係するステップがない場合、矢印を得るだけです。見い出すことができます。実行する必要があり図の下で説明されるステップが参照される呼び出し(callout)を持っています。必要なエリアを表示すべきだけで、必要ではない全体の画面、URLアドレスバーなどは表示すべきではありません。指令によって追加されます。最初の行はファイルのパスを提供します。適切なファイルを選択します。したがって、ファイルは異なるイメージ拡張子を持つことができるか、または、マニュアルの最終フォーマットに最も適するようにプログラムによってそのとき選択される別のファイルフォーマットで、同じスクリーンショットをあなたは持つことができます。Maharaユーザマニュアルのために、私達がスクリーンショットを取り扱うとき、私達は一般に.pngファイルを使います。いつかファイルフォーマットが変更されるのに備えて、.png拡張子の代わりに*を使うのがまだよいです。2行目は、イメージに移動するとき、イメージが表示されないとき、または画面リーダでページを見るときに表示される代替テキストを表しています。3行目は空行に続く必要があります。これはスクリーンショットの下に図の説明として表示されるテキストです。PDF出力では、説明は連続的に番号を付けられます。使い、それをあなたのスクリーンショットに置くことができます。CCCCCC注釈イメージをインラインでテキストに含めたい場合で、標準の図を使用したくない、または使用できない場合、あなたは置換を作成し、それをshortcuts.rstextファイルに配置する必要があります。ショートカットファイルに多くの例があります。注意が必要なすべてのことです。注意は、箇条書き(ビュレット付きのリスト)内に直接置くことができます。いつものように、注意の前後に空行を置く必要があり、忠告は三つの空白で字下げする必要があります。注意しながら実施する必要のあるすべてのことです。本当に重要な情報を失ってしまうため、すべてを警告内に入れないようにします。他の文書の参照のために、それらに特別な配慮が必要です。他の文書の参照はまた、テキストインラインに含めることができます。SphinxによってrSTを使用するあなたの知識と理解を深める(deepend)のに最高の場所です。実行しているやるべきことのリストを保持するために。やるべきことのリストは現在無効です。