Jekyll 搭建新网站的脚手架。 https://marcanuy.github.io/jekyll-sculpture/
目录
这是一个使用jekyll new --blank
创建的基本 Jekyll 网站(没有主题或示例帖子),可作为任何网站的起点。
其目的是快速启动新网站,克隆此存储库并根据您的需求进行定制,已经拥有我每次创建新 Jekyll 实例时添加和配置的所有功能。
现场演示看起来如此“简约”,因为它不使用任何主题,其唯一目标是展示网站导航的设计以及如何添加帖子/类别。
其结构使用如何以正确的方式将 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>
规范网址
<link rel="canonical" href="..."/>
分页页面上的下一个和上一个 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>
Open Graph 标题、描述、网站标题和 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-sculpture 的构建遵循以下原则:
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
等。
帖子 front-matter 中使用以下属性:
---
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-sculpture使用以下插件:
如果您想在 Github 中托管从此存储库派生的站点,您可以遵循以下指南:使用 Git 推送到 Github 将 Jekyll 网站自动部署到 Github 页面 。
$进行构建 rm -fr_site/ rm -fr 资产/供应商/ #from 纱线 rm -fr 资产/字体 #fontawesome 依赖项 rm -fr .sass_cache 捆绑安装--路径供应商/捆绑程序 警告:Bundler 的运行版本 (1.13.6) 早于创建锁定文件的版本 (1.15.0)。我们建议您通过运行“gem install bundler”升级到最新版本的 Bundler。 使用并发 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 使用 kramdown 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 使用 nokogiri 1.7.2 使用 jekyll-sass-converter 1.5.0 使用 ActiveSupport 5.1.1 使用伤寒 0.8.0 使用监听3.0.8 使用 jekyll-toc 0.2.1 使用 html-proofer 3.7.2 使用 jekyll-watch 1.5.0 使用jekyll 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 资产/供应商/ cp -r node_modules/font-awesome/字体资源 cp node_modules/jquery/dist/jquery.min.js 资产/供应商/ cp node_modules/tether/dist/js/tether.min.js 资产/供应商/ cp node_modules/bootstrap/dist/js/bootstrap.min.js 资产/供应商/ 捆绑执行 jekyll 构建 配置文件:/tmp/jekyll-sculpture/_config.yml 来源:/tmp/jekyll-骨骼 目的地:/tmp/jekyll-sculpture/_site 增量构建:禁用。使用 --incremental 启用 生成... 5.474 秒内完成。 自动再生:禁用。使用 --watch 来启用。 $树 -L 3 _site/ _地点/ ├── 资产 │ ├── 字体 │ │ ├── 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 ├── 部署_key.enc ├── zh │ ├── example-post.html │ ├──index.html │ └── 子类别1 │ ├──index.html │ └── post-in-subdirectory.html ├── es │ ├──index.html │ ├── post-ejemplo.html │ └── 子类别1 │ ├──index.html │ └── post-en-subdirectorio.html ├── feed.xml ├── 索引.html ├── 许可证 ├── package.json ├── 自述文件.md ├── 机器人.txt ├── 站点地图.xml └── 纱线.lock 9个目录,32个文件 $进行检查 捆绑执行杰基尔医生 配置文件:/tmp/jekyll-sculpture/_config.yml 你的测试结果出来了。一切看起来都很好。 捆绑执行 htmlproofer --check-html --http-status-ignore 999 --内部域 marcanuy.github.io,localhost:4000 --假设扩展名 _地点 在 *.html 上的 [“_site”] 上运行 [“ScriptCheck”、“LinkCheck”、“HtmlCheck”、“ImageCheck”]... 正在检查 14 个外部链接... 跑了 13 个文件! HTML-Proofer 已成功完成。
请随意提出问题和/或贡献!