Perancah Jekyll untuk memulai situs web baru. https://marcanuy.github.io/jekyll-skeleton/
Daftar isi
Ini adalah situs Jekyll dasar yang dibuat dengan jekyll new --blank
(tanpa tema, atau contoh postingan) sebagai titik awal untuk situs web apa pun.
Tujuannya adalah untuk segera memulai situs web baru yang mengkloning repo ini dan menyesuaikannya dengan kebutuhan Anda, sudah memiliki semua fitur yang saya tambahkan dan konfigurasikan setiap kali saya membuat instance Jekyll baru.
Live demo terlihat begitu “ minimalis ” karena tidak menggunakan tema apapun dan tujuannya hanya untuk menampilkan desain navigasi website dan cara menambahkan postingan/kategori.
Strukturnya menggunakan desain yang dijelaskan dalam artikel Cara Menambahkan Bootstrap 4 Ke Jekyll dengan Benar, Jekyll Multibahasa Tanpa Plugin, dan Cara Mengimplementasikan Breadcrumbs Di Situs Jekyll Dengan Kategori Bersarang yang diterapkan pada instance Jekyll kosong dengan saran yang diberikan oleh plugin di bawah ini.
Cukup kloning repo ini dan mulailah membangun repo Anda.
git clone [email protected]:marcanuy/jekyll-skeleton.git
Secara otomatis menghasilkan di setiap jekyll build :
/sitemap.xml
/feed.xml
. SASS dan penyesuaian variabel Bootstrap 4 yang mudah di /assets/main.scss
dan /_sass/_variables.scss
.
Secara otomatis menambahkan tag metadata untuk Mesin Pencari dan Jejaring Sosial
Judul halaman, dengan judul situs atau deskripsi ditambahkan
<head>
<title>...</title>
</head>
Deskripsi halaman
<head>
<meta name="description" content="..."/>
</head>
URL kanonik
<link rel="canonical" href="..."/>
URL berikutnya dan sebelumnya pada halaman yang diberi nomor halaman
Situs JSON-LD dan metadata postingan untuk pengindeksan yang lebih kaya
<meta property="fb:app_id" content="1822851531277021"/>
<script type="application/ld+json">
{"@context": "http://schema.org",
"@type": "WebPage",
"headline": "...",
"description": "...",
"url": "..."}</script>
Judul Grafik Terbuka, deskripsi, judul situs, dan URL (untuk Facebook, LinkedIn, dll.)
<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="..."/>
Metadata Kartu Ringkasan Twitter
<meta name="twitter:card" content="summary"/>
<meta name="twitter:site" content="..."/>
<meta name="twitter:creator" content="..."/>
Multibahasa
Menu navigasi bahasa untuk setiap halaman ke semua versi terjemahan lainnya
<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" />
Elemen tautan alternatif di bagian head
HTML
<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" />
Pengalihan dari subfolder bahasa default ke beranda situs ( /en
-> /
)
Remah roti untuk halaman dan postingan
<!-- 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 telah dibangun dengan prinsip-prinsip berikut:
jekyll-seo-tag
.git clone https://github.com/marcanuy/jekyll-skeleton
cd jekyll-seleton
make install
make serve
Tambahkan bahasa ke _config.yml
:
defaults:
#languages
-
scope:
path: ""
values:
lang: "en"
layout: default
-
scope:
path: "es"
values:
lang: "es"
Namanya menjadi _data/locales.yml
dan setara dengan setiap halaman dalam bahasa di /_data/map.yml
:
-
en: index.html
es: es/index.html
-
en: about.html
es: es/acerca.html
Tambahkan postingan dalam setiap bahasa yang terletak di subdirektori bahasa: /en
, es
, dll.
Properti berikut di materi depan postingan digunakan:
---
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 menggunakan plugin berikut:
Jika Anda ingin menghosting situs yang berasal dari repo ini di Github, Anda dapat mengikuti panduan ini: Penerapan Otomatis Situs Web Jekyll Ke Halaman Github Dengan Git Push Ke Github.
$ membuat pembangunan rm -fr _situs/ rm -fr aset/vendor/ #dari benang rm -fr aset/font #fontawesome ketergantungan rm -fr .sass_cache pemasangan bundel --path vendor/bundler Peringatan: versi Bundler yang berjalan (1.13.6) lebih lama dari versi yang membuat lockfile (1.15.0). Kami menyarankan Anda meningkatkan ke versi terbaru Bundler dengan menjalankan `gem install bundler`. Menggunakan ruby bersamaan 1.0.5 Menggunakan i18n 0.8.1 Menggunakan uji coba mini 5.10.2 Menggunakan thread_safe 0.3.6 Menggunakan public_suffix 2.0.5 Menggunakan pewarna 1.1.0 Menggunakan berwarna 1.2 Menggunakan ffi 1.9.18 Menggunakan forwardable-extend 2.6.0 Menggunakan tentara bayaran 0.3.6 Menggunakan mini_portile2 2.1.0 Menggunakan paralel 1.11.2 Menggunakan teriakan 2.0.7 Menggunakan sass 3.4.24 Menggunakan rb-fsevent 0.9.8 Menggunakan kramdown 1.13.2 Menggunakan cairan 3.0.6 Menggunakan pemerah pipi 1.11.1 Menggunakan safe_yaml 1.0.4 Menggunakan bundel 1.13.6 Menggunakan tzinfo 1.2.3 Menggunakan alamat 2.5.1 Menggunakan eton 0.10.1 Menggunakan rb-inotify 0.9.8 Menggunakan pathutil 0.14.0 Menggunakan nokogiri 1.7.2 Menggunakan jekyll-sass-converter 1.5.0 Menggunakan dukungan aktif 5.1.1 Menggunakan tipus 0.8.0 Menggunakan mendengarkan 3.0.8 Menggunakan jekyll-toc 0.2.1 Menggunakan html-proofer 3.7.2 Menggunakan jekyll-watch 1.5.0 Menggunakan jekyll 3.4.3 Menggunakan jekyll-feed 0.9.2 Menggunakan jekyll-redirect-dari 0.12.1 Menggunakan jekyll-seo-tag 2.2.3 Menggunakan jekyll-sitemap 1.1.1 Paket selesai! 7 dependensi Gemfile, 38 permata sekarang terpasang. Permata yang dibundel dipasang ke ./vendor/bundler. pemasangan benang pemasangan benang v0.24.5 [1/4] Menyelesaikan paket... sukses Sudah up-to-date. Selesai dalam 0,38 detik. mkdir -p aset/vendor/ cp node_modules/font-awesome/css/font-awesome.min.css aset/vendor/ cp -r node_modules/font-awesome/aset font cp node_modules/jquery/dist/jquery.min.js aset/vendor/ cp node_modules/tether/dist/js/tether.min.js aset/vendor/ cp node_modules/bootstrap/dist/js/bootstrap.min.js aset/vendor/ bundel exec jekyll build File konfigurasi: /tmp/jekyll-skeleton/_config.yml Sumber: /tmp/jekyll-skeleton Tujuan: /tmp/jekyll-skeleton/_site Pembangunan tambahan: dinonaktifkan. Aktifkan dengan --inkremental Menghasilkan... selesai dalam 5,474 detik. Regenerasi otomatis: dinonaktifkan. Gunakan --watch untuk mengaktifkan. $ pohon -L 3 _situs/ _lokasi/ ├── aset │ ├── font │ │ ├── FontAwesome.otf │ │ ├── fontawesome-webfont.eot │ │ ├── fontawesome-webfont.svg │ │ ├── fontawesome-webfont.ttf │ │ ├── fontawesome-webfont.woff │ │ └── fontawesome-webfont.woff2 │ ├── main.css │ └── penjual │ ├── bootstrap.min.js │ ├── font-mengagumkan.min.css │ ├── jquery.min.js │ └── tether.min.js ├── de │ ├── beispiel-post.html │ ├── indeks.html │ └── unterkategorie1 │ ├── indeks.html │ └── pasca-dalam-unterkategorie.html ├── deploy_key.enc ├── id │ ├── contoh-posting.html │ ├── indeks.html │ └── subkategori1 │ ├── indeks.html │ └── pasca-di-subdirektori.html ├── ya │ ├── indeks.html │ ├── pasca-ejemplo.html │ └── subkategori1 │ ├── indeks.html │ └── pasca-en-subdirektori.html ├── umpan.xml ├── indeks.html ├── LISENSI ├── paket.json ├── README.md ├── robots.txt ├── peta situs.xml └── benang.kunci 9 direktori, 32 file $ lakukan pengecekan bundel exec jekyll dokter File konfigurasi: /tmp/jekyll-skeleton/_config.yml Hasil tes Anda sudah masuk. Semuanya tampak baik-baik saja. bundel exec htmlproofer --check-html --http-status-abaikan 999 --domain-internal marcanuy.github.io,localhost:4000 --anggap-ekstensi _lokasi Menjalankan ["ScriptCheck", "LinkCheck", "HtmlCheck", "ImageCheck"] di ["_site"] di *.html... Memeriksa 14 tautan eksternal... Jalankan pada 13 file! Pembuktian HTML selesai dengan sukses.
Jangan ragu untuk membuka masalah dan/atau berkontribusi!