expressjs.com

Expressjs.com

これは、WebサイトExpressjs.comのリポジトリです。 GitHubページのWebサイトとしてリポジトリから直接ホストされています。

ローカルセットアップ

ウェブサイトをローカルにプレビューするには：

1. RubyとBundlerをまだ持っていない場合は、インストールしてください。

2. Jekyll-Redirect-from Gemをインストールします。

   $ gem install jekyll-redirect-from

3. 次のコマンドを実行して、このリポジトリをクローンします。

   $ git clone https://github.com/expressjs/expressjs.com.git

4. クローン化されたリポジトリディレクトリに移動し、次のコマンドを実行します。

   $ bundle install

   バンドラーは、インストールする宝石の宝石を見ます。 github-pages Gemには、Githubページで使用されている同じバージョンのJekyllとその他の依存関係が含まれているため、ローカルセットアップはGitHubページをできるだけ密接に反映しています。

5. 次のコマンドを使用してJekyllを実行します。

   $ bundle exec jekyll serve

   次に、ブラウザにhttp：// localhost：4000をロードします。

Dockerを使用したローカルセットアップ

ヒント

make helpを実行して、Makeコマンドの使用方法に関する詳細情報を取得できます。

0. Dockerを持っていることを確認し、インストールしてください。
1. プロジェクトを構築するためにmake build実行します。
2. プロジェクトにサービスを提供するためにmake serveます。これには、変更が反映されるようにライブリロードが含まれます（ログを確認することができます）。
3. 実行して、生成されたDockerの画像とリソースを削除するためにmake clean 。

フォーマット

Jekyllは、Kramdownとして知られるMarkdownのバリアントを使用しています。

Jekyllは、テンプレートに液体テンプレートエンジンを使用しています。

JavaScriptにGFMフェンスで囲まれたコードブロックを使用できます。例えば：

 「JS」
var Express = require（ 'Express'）
var app = express（）
app.listen（3000）
`` `

結果は次のようになります：

 const express = require ( 'express' )
const app = express ( )
app . listen ( 3000 )

デフォルトのgithubページの構文ハイライトは、 _config.ymlで無効にされており、prism.jsでハイライトを付けることができます。

貢献

テンプレートファイルまたはドキュメントファイルを自由に変更してください。サポートドキュメントはそれぞれのディレクトリにあり、APIドキュメントは_includesディレクトリの下にあります。

翻訳の貢献に関する情報など、ドキュメントへの貢献の詳細については、貢献者ガイドをご覧ください。

エクスプレスベースのソリューションの代わりにジキルを使用するのはなぜですか？

JekyllにはGithubページが組み込まれています。すでにGithubページを使用してWebサイトをホストしているため、提供する機能を活用することは理にかなっています。それはすべて、適切な仕事のために、適切な状況下で適切なツールを使用することです。