**GitBook **はNode.jsに基づくコマンドラインツールであり、Github / GitとMarkdownを使用して美しい電子書籍を作成できます。
GitBookは、複数のドキュメント形式をサポートしています。
静的サイト:GitBookはデフォルトでこの形式を出力し、生成された静的サイトはGithubPagesサービスで直接ホストできます。
PDF:gitbook-pdf依存関係をインストールする必要があります。
eBook:ebook-convertをインストールする必要があります。
シングルHTMLWebページ:コンテンツをシングルページHTMLとして出力することをサポートしますが、通常、e-book形式をPDFまたはeBookに変換する中間プロセスで使用されます。
JSON:通常、電子書籍のデバッグまたはメタデータの抽出に使用されます。
GitBookを使用して電子書籍を作成するには、README.mdとSUMMARY.mdの2つのファイルが必要です。
以下に、CentOS7システムでGitBookを展開する方法について説明します
1) Node.jsのLinux64ビットバイナリパッケージを公式ウェブサイトからダウンロードします
wgethttps://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xzをダウンロードします
2) 指定したディレクトリに解凍します
tar -xJf node-v12.16.1-linux-x64.tar.xz -C /usr/local/lib/
cd /usr/local/lib
mv node-v12.16.1-linux-x64/ nodejs
**3) 環境変数vi / etc / profile **を変更します
export PATH=/usr/local/lib/nodejs/bin:$PATH
source /etc/profile
そして、npmコマンドがあるかどうかをテストし、npm-vと入力してnpmのバージョンを表示します
**4) npm **を使用してgitbook-cliをインストールします
npm install -g gitbook-cli
gitbook--versionバージョン情報を表示します。gitbookは実行時に自動的にインストールされます
**5) gitbook init **
gitbookが初期化され、README.mdおよびSUMMARY.mdディレクトリファイルが作成されます
README.mdは説明文書であり、Summary.mdは実際には本の章リストです。
6) Summary.mdファイルの例を編集します
[ 第1章](Chapter1 / README.md)
[ セクション1:一般的なスクリプト](第1章/一般的なScripts.md)
[ セクション2:一般的なコマンド](第1章/一般的なCommands.md)
[ セクション3:Linuxリリースバージョン](第1章/ Linuxリリースversion.md)
[ セクション4:CentOS8](Chapter1 / CentOS8.md)
[ 第2章](Chapter2 / README.md)
[ 第3章](Chapter3 / README.md)
[ 第4章](Chapter4 / README.md)
gitbookinitコマンドを再度実行します。 GitBookは、Summary.mdファイルに記述されているディレクトリとファイルを検索します。そうでない場合は、それらを作成します。
次に、gitbookserveを実行します
ポート4000にアクセスするためのWebブラウザ
もちろん、手動でポートを80に指定することもできます。
gitbook serve --port 80
上記はgitbookの展開です。マークダウン編集ツールを使用して、mdファイルのコンテンツを書き込んでから、電子書籍を公開できます。
概要:gitbookはMarkdownとGitと密接に関連しており、通常は組み合わせて使用されます
1、 適切なマークダウン編集ツールを選択して、より良い書き込みエクスペリエンスを実現します。GitBookを使用してドキュメントを管理し、プレビューして電子書籍を作成します。
2、 同時に、Gitを介して本のコンテンツの変更を管理し、それらをクラウド(GitHub、GitLab、Code Cloud、または自分で構築したGitサーバーなど)でホストして、複数人のコラボレーションを実現します
Recommended Posts