manual_edit

  改訂作業中のマニュアル

改訂作業の進み具合の最新情報については、

• GitHub のissue 975 を参照してください。

 マニュアルを書く同志を募集しています

マニュアルを書く同志を募集しています。我こそはという方、ぜひ、ご参加ください。

参加方法

1. GitHub のアカウントがなければ作成する
2. 連絡先宛てにEnjuマニュアル作成参加の旨、GitHubのアカウントとともにご連絡ください。連絡はメールでもTwitterでもどちらでもかまいません。
3. （必要に応じて）編集方針等、不明な点があれば、 Issue から新しいIssueを立てて、質問や意見等をお気軽にお送りいただけると助かります。

 マニュアルの更新方法

（GitHub, git, AsciiDoc, jekyllについては知っているものとして説明します）

• 1. GitHubからマニュアルのソースファイルを取得する
  • git clone https://github.com/next-l/documentation.git
  • これで、documentation フォルダができる
  • .adoc ファイルがマニュアルの実際のファイル。AsciiDoc方式で書いています
• 2. 環境をととのえる
  • cd documentation
  • bundle update
    • 必要なソフトがインストールされます
• 3. マニュアルを修正します
  • お好きなエディタで編集して内容を書いてください。
• 4. （任意）jekyll buildコマンドでプレビューできます。
  • _sites/ ディレクトリ下に実際に閲覧されるHTMLが出力されていますので、見栄えを確認できます。
• 5. 反映させる
  • git commit および git push コマンドで GitHub サイト上に反映させることができます。
  • push する権限が無い場合はML等でリクエストしてください。または、Forkしてから修正内容を pull request していただいても構いません）
  • 不明な点は、Issue登録するか、MLで質問をお願いします。

• 参考： AsciiDoc https://ja.wikipedia.org/wiki/AsciiDoc
• 参考： jekyll https://jekyllrb.com/

マニュアルのファイル構造

マニュアルの改訂作業をスムーズにするために、内容に応じて複数のファイルに分割して作業をすすめています。

• テキストファイル
  • 本文 documentation/バージョン/*.adoc
    • 例： documentation/1.4/*.adoc
  • 全体の目次 https://next-l.github.io/documentation/ → manual/index.adoc
  • 各マニュアルの目次 documentation/enju_*_toc.adoc
    • 例：利用者マニュアル　https://next-l.github.io/documentation/1.4/enju_user.html　→ documentation/_includes/enju_user_toc.adoc
    • 各マニュアルの目次はバージョン共通ですので、バージョンによって変わる場合は別ファイルにする処理をしてください。
• 画像ファイル
  • 画像ファイルは documentation/assets/images/バージョン/*.png
    • 例： documentation/1.4/*.png

関連リンク

・公開中のマニュアル