この記事は機械翻訳のミラー記事です。元の記事にジャンプするにはこちらをクリックしてください。

Architect_Programmer_Code農業ネットワーク»建築家 › プログラミング › その他の番組編成 › GitBookチュートリアルの始め方
眺める： 7163|答える： 0

GitBookチュートリアルの始め方

[リンクをコピー]
掲載地 2018/11/23 14:03:54 | | | |
GitBookはNode.jsベースのコマンドラインツールで、MarkdownおよびAsciiDocの構文形式をサポートし、HTML、PDF、eBookなどの形式で電子書籍を出力できます。

インストールnode.js

gitbookツールを使う前に、コンピュータが環境をインストールし、インストール後にバージョンコマンドでインストールが成功しているかどうかを確認する必要がありますnode.js:


Gitbookをインストールする

Gitbookはnpmでインストールされており、コマンドラインは以下の通りです:



以下のコマンドを実行して、インストールが成功したかどうかを確認するためにGitBookのバージョンを確認してください。

インストール履歴バージョン

gitbook-cliは、他のバージョンのGitBookをダウンロード・インストールして本のテストを簡単にします:



gitbook ls-remoteを使うとダウンロード可能なバージョンが列挙されます。


マークダウンエディタ

ここでは文書の執筆言語としてMarkdownの構文を使用しています。Markdownエディタを準備する必要があります。市場にはTypora、MacDown、Bear、MarkdownPad、MarkdownX、JetBrainsのIDE(プラグインインストールが必要)、Atom、Jianshu、CSDN、そしてGitBook独自のものなど多くのMarkdownエディタがあります GitBook Editorなどです。

私はPCにVS Code開発ツールをインストールしていますが、VS CodeはデフォルトでMarkdownをサポートしています。プレビュープラグインのアーティファクト「Markdown Preview Enhanced」をインストールするだけで、それを使うつもりです!



友人による推薦 編集者タイポラ、住所:ハイパーリンクのログインが見えます。

ブックの初期化

GitBookはボイラープレートを設定できます:

新しいディレクトリに本を作成したい場合は、gitbook init ./directoryを実行することでできます。

実行後、さらに2つのファイル、README.md と SUMMARY.md が表示され、以下の機能を行います。

README.md - 本書の序文はこの文書に記載されています
SUMMARY.md - 本書のカタログ構成はこちらに設定されています



マークダウンの構文には詳しくないので、数文だけ書いてみてください!






静的ウェブページを生成する

静的なウェブページを生成し、サーバーを稼働させる

これらすべては書籍カタログ_bookで生成されます。


serveコマンドはポートを指定することもできます:




生成時にはgitbookのバージョンを指定し、ローカルでダウンロードされることはありません



すべてのローカルgitbookバージョンを一覧にしています



リモートで利用可能なgitbookのバージョンをリストアップします



対応するgitbookバージョンをインストールしてください



gitbookの最新バージョンへのアップデート



対応するgitbook版をアンインストールしてください


ログのレベルを指定します



出力エラーメッセージ



概要

GitBookは SUMMARY.md ファイルを用いて本の章やサブ章の構成を定義します。 SUMMARY.md ファイルは本の目次を生成するために使用されます。

SUMMARY.md の形式はリンクのリストです。 リンクのタイトルは章のタイトルとして機能し、その章ファイルへのパスをターゲットにします。

親チャプターにネストリストを追加すると子チャプターが作成されます。

簡単な例:


その後、コマンドラインに戻り、mybookフォルダでgitbookのinitコマンドを再度実行します。 GitBookは SUMMARY.md ファイルに記載されたディレクトリやファイルを検索します。そうでなければ、その創造が成立します。

PDF、ePub、またはmobiファイルを出力してください

PDF版を生成したい場合は、gitbook pdfを実行できます。epub形式をエクスポートする場合はgitbook epub、mobi形式ならgitbook mobiで対応します。



もし電子書籍をPDF、ePub、またはMobi形式でエクスポートしたい場合は、Calibreの電子書籍リーダー/マネージャーおよびコマンドラインツールが必要です、そうでなければ「EbookError: Error during ebook generation: 'ebook-convert'」とエラーが報告されることがあります。

GitBook Special Filesの特徴:

ファイル
形容
book.json構成データ(任意)
README.md電子書籍の序文または序文(必須)
SUMMARY.md電子書籍カタログ(任意)
GLOSSARY.md語彙/注釈用語一覧(任意)
Gitbook一般設定

GitBookは柔軟な設定で電子書籍をカスタマイズできます。

これらのオプションはbook.jsonファイルに指定されています。 JSON構文に慣れていない著者のために、JSONlintのようなツールを使って構文を検証できます。

可変
形容
根すべての本ファイルを含むルートフォルダへのパスbook.json
構成readme、要旨、用語集などのパスを指定します
タイトルあなたの本のタイトル、デフォルト値はREADMEから抽出されています。 GitBook.com では、このフィールドは事前に埋められています。
Descrip{filter}tionあなたの本の説明、デフォルト値はREADMEから抽出されます。 GitBook.com では、このフィールドは事前に埋められています。
著者作者名。 GitBook.com では、このフィールドは事前に埋められています。
ISBNISBN
言語この本の言語タイプはISOコードです。 デフォルト値は en です。
演出テキストの読書順。 それはRTL(右から左)またはLTR(左から右へ)であり、デフォルト値は言語の値に依存します。
gitbookGitBook版を使うべきです。 SemVer仕様を使用し、「> = 3.0.0」のような条件を受け入れてください。





先の：Bona Cloudのコードを手に入れましたか?
次に：vscodeで正しいポーズをマークダウンに書きます

関連記事
免責事項：
Code Farmer Networkが発行するすべてのソフトウェア、プログラミング資料、記事は学習および研究目的のみを目的としています。 上記の内容は商業的または違法な目的で使用されてはならず、そうでなければ利用者はすべての結果を負うことになります。 このサイトの情報はインターネットからのものであり、著作権紛争はこのサイトとは関係ありません。 ダウンロード後24時間以内に上記の内容を完全にパソコンから削除してください。 もしこのプログラムを気に入ったら、正規のソフトウェアを支持し、登録を購入し、より良い本物のサービスを受けてください。 もし侵害があれば、メールでご連絡ください。
Mail To:help@itsvse.com