新しいウェブサイトを開始するためのジキル足場。 https://marcanuy.github.io/jekyll-skeleton/
目次
これは、 jekyll new --blank
(テーマや投稿例なし) を使用して作成された基本的な Jekyll サイトで、Web サイトの出発点として機能します。
その目的は、このリポジトリを複製し、ニーズに合わせてカスタマイズする新しい Web サイトを迅速に開始し、新しい Jekyll インスタンスを作成するたびに追加および構成していたすべての機能をすでに備えていることです。
ライブデモはテーマを一切使用しておらず、Web サイトのナビゲーションのデザインと投稿/カテゴリの追加方法を示すことだけが目的であるため、非常に「ミニマル」に見えます。
その構造は、「正しい方法で Bootstrap 4 を Jekyll に追加する方法」、「プラグインを使用しない多言語 Jekyll 」、および「ネストされたカテゴリを持つ Jekyll サイトにブレッドクラムを実装する方法」の記事で説明されている設計を使用しており、以下のプラグインによって提供される提案を使用して空の Jekyll インスタンスに適用されます。
このリポジトリのクローンを作成して、リポジトリの構築を開始してください。
git clone [email protected]:marcanuy/jekyll-skeleton.git
jekyll ビルドごとに自動的に生成されます。
/sitemap.xml
/feed.xml
にあります。 SASS と/assets/main.scss
および/_sass/_variables.scss
の Bootstrap 4 変数の簡単なカスタマイズ。
検索エンジンとソーシャルネットワークのメタデータタグを自動的に追加します
ページ タイトル (サイト タイトルまたは説明が追加されたもの)
<head>
<title>...</title>
</head>
ページの説明
<head>
<meta name="description" content="..."/>
</head>
正規の URL
<link rel="canonical" href="..."/>
ページ分割されたページの次の URL と前の URL
JSON-LD サイトとポストのメタデータによるより豊富なインデックス作成
<meta property="fb:app_id" content="1822851531277021"/>
<script type="application/ld+json">
{"@context": "http://schema.org",
"@type": "WebPage",
"headline": "...",
"description": "...",
"url": "..."}</script>
オープングラフのタイトル、説明、サイトのタイトル、URL (Facebook、LinkedIn など)
<meta property="og:title" content="..."/>
<meta name="description" content="..."/>
<meta property="og:description" content="..."/>
<meta property="og:url" content="..."/>
<meta property="og:site_name" content="..."/>
<meta property="og:type" content="..."/>
<meta property="article:published_time" content="..."/>
<meta property="fb:app_id" content="..."/>
Twitter サマリー カードのメタデータ
<meta name="twitter:card" content="summary"/>
<meta name="twitter:site" content="..."/>
<meta name="twitter:creator" content="..."/>
多言語
各ページの他のすべての翻訳バージョンへの言語ナビゲーション メニュー
<a hreflang="es" href="http://example.com/es/foobar" />
<a hreflang="de" href="http://example.com/de/foobar" />
<a hreflang="en" href="http://example.com/en/foobar" />
HTML のhead
セクションの代替リンク要素
<link rel="alternate" hreflang="es" href="http://example.com/es" />
<link rel="alternate" hreflang="de" href="http://example.com/de" />
<link rel="alternate" hreflang="en" href="http://example.com/en" />
デフォルト言語のサブフォルダーからサイトのホームページにリダイレクトします ( /en
-> /
)
ページと投稿のブレッドクラム
<!-- url: /jekyll-skeleton/en/example-post -->
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="/jekyll-skeleton/"><i class="fa fa-home" aria-hidden="true"></i></a></li>
<li class="breadcrumb-item ">
<a href="/jekyll-skeleton/en">en</a>
</li>
<li class="breadcrumb-item active">
Example Post
</li>
</ol>
jekyll-skeleton は、次の原則を念頭に置いて構築されています。
jekyll-seo-tag
使用に関する提案に従います。git clone https://github.com/marcanuy/jekyll-skeleton
cd jekyll-seleton
make install
make serve
言語を_config.yml
に追加します。
defaults:
#languages
-
scope:
path: ""
values:
lang: "en"
layout: default
-
scope:
path: "es"
values:
lang: "es"
その名前は_data/locales.yml
で、 /_data/map.yml
の言語の各ページに相当します。
-
en: index.html
es: es/index.html
-
en: about.html
es: es/acerca.html
言語サブディレクトリにある各言語で投稿を追加します: /en
、 es
など。
投稿のフロントマターでは次のプロパティが使用されます。
---
title: # jekyll-seo-tag - The title of the post, page, or document
description: # jekyll-seo-tag - A short description of the page's content
image: # jekyll-seo-tag - URL to an image associated with the post, page, or document (e.g., /assets/page-pic.jpg)
author: # jekyll-seo-tag - Page-, post-, or document-specific author information (see below)
lang: # jekyll-seo-tag - Page-, post-, or document-specific language information
---
Jekyll-skeleton は次のプラグインを使用します。
このリポジトリから派生したサイトを Github でホストする場合は、このガイドに従ってください: Git Push To Github を使用した Github ページへの Jekyll Web サイトの自動デプロイメント 。
$メイクビルド rm -fr_site/ rm -fr 資産/ベンダー/ #糸から rm -fr アセット/フォント #fontawesome 依存関係 rm -fr .sass_cache バンドルインストール --パスベンダー/バンドラー 警告: Bundler の実行バージョン (1.13.6) は、ロックファイルを作成したバージョン (1.15.0) よりも古いです。 「gem install Bundler」を実行して、Bundler の最新バージョンにアップグレードすることをお勧めします。 concurrent-ruby 1.0.5 の使用 i18n 0.8.1 の使用 ミニテスト 5.10.2 の使用 thread_safe 0.3.6 の使用 public_suffix 2.0.5 の使用 カラーレーター 1.1.0 の使用 カラー版 1.2 の使用 ffi 1.9.18 を使用する 転送可能拡張 2.6.0 の使用 傭兵0.3.6の使用 mini_portile2 2.1.0 の使用 パラレル 1.11.2 の使用 エール2.0.7の使用 Sass 3.4.24 の使用 rb-fsevent 0.9.8 の使用 クラムダウン 1.13.2 の使用 液体3.0.6の使用 ルージュ1.11.1を使用する safe_yaml 1.0.4 の使用 バンドラー 1.13.6 の使用 tzinfo 1.2.3 の使用 アドレス可能な 2.5.1 の使用 ethon 0.10.1の使用 rb-inotify 0.9.8 の使用 pathutil 0.14.0の使用 ノコギリ 1.7.2 の使用 jekyll-sass-converter 1.5.0 の使用 アクティブサポート 5.1.1 の使用 腸チフス0.8.0の使用 listen 3.0.8の使用 jekyll-toc 0.2.1 の使用 htmlプルーファー3.7.2の使用 jekyll-watch 1.5.0の使用 ジキル 3.4.3 の使用 jekyll-feed 0.9.2 の使用 jekyll-redirect-from 0.12.1 の使用 jekyll-seo-tag 2.2.3 の使用 jekyll-sitemap 1.1.1 の使用 バンドルが完成しました! 7 つの Gemfile 依存関係、38 個の gem がインストールされました。 バンドルされた gem は ./vendor/bundler にインストールされます。 糸のインストール 糸インストール v0.24.5 [1/4] パッケージを解決しています... 成功 すでに最新です。 0.38秒で完了。 mkdir -p 資産/ベンダー/ cp node_modules/font-awesome/css/font-awesome.min.css 資産/vendor/ cp -r node_modules/font-awesome/fonts アセット cp node_modules/jquery/dist/jquery.min.js 資産/vendor/ cp node_modules/tether/dist/js/tether.min.jsassets/vendor/ cp node_modules/bootstrap/dist/js/bootstrap.min.jsassets/vendor/ バンドル実行ジキルビルド 設定ファイル: /tmp/jekyll-skeleton/_config.yml 出典: /tmp/jekyll-skeleton 宛先: /tmp/jekyll-skeleton/_site インクリメンタルビルド: 無効。 --incremental で有効にする 生成中... 5.474秒で完了しました。 自動再生: 無効。有効にするには --watch を使用します。 $ツリー -L3 _サイト/ _サイト/ §── 資産 │ §── フォント │ │ §── FontAwesome.otf │ │ §── fontawesome-webfont.eot │ │ §── fontawesome-webfont.svg │ │ §── fontawesome-webfont.ttf │ │ §── fontawesome-webfont.woff │ │ └── fontawesome-webfont.woff2 │ §── main.css │ └── ベンダー │ §── bootstrap.min.js │ §── font-awesome.min.css │ §── jquery.min.js │ └── tether.min.js §──で │ §── beispiel-post.html │ §──index.html │ └── カテゴリー1 │ §──index.html │ └── post-in-unterkategorie.html §──deploy_key.enc §── ja │ §── example-post.html │ §──index.html │ └── サブカテゴリー1 │ §──index.html │ └── post-in-subdirectory.html §── エス │ §──index.html │ §── post-ejemplo.html │ └── サブカテゴリ1 │ §──index.html │ └── post-en-subdirectorio.html §── feed.xml §──index.html §── ライセンス §── package.json §── README.md §── robots.txt §── sitemap.xml └── 糸.ロック 9 ディレクトリ、32 ファイル $小切手を作る バンドル幹部ジキル博士 設定ファイル: /tmp/jekyll-skeleton/_config.yml テスト結果が届きました。すべて問題ないようです。 バンドル実行 htmlproofer --check-html --http-status-ignore 999 --internal-domains marcanuy.github.io,localhost:4000 --assume-extension _サイト *.html の ["_site"] で ["ScriptCheck"、"LinkCheck"、"HtmlCheck"、"ImageCheck"] を実行中... 14 個の外部リンクをチェックしています... 13 個のファイルで実行されました。 HTML-Proofer が正常に終了しました。
気軽に問題を開いたり、貢献したりしてください。