这是一个分步教程,可以让您开始使用流行的静态站点生成器Jekyll:
步骤1:安装先决条件
- 确保您在系统上安装了Ruby的最新版本。
- 安装Rubygems,Ruby的软件包管理器。
- 安装node.js,这是jekyll的资产管道所需的。
- 通过在终端中运行以下命令来安装jekyll GEM:
gem install jekyll
。
步骤2:创建一个新的jekyll网站
- 打开终端并导航到您要创建jekyll网站的目录。
- 运行命令
jekyll new mysite
以生成一个新的jekyll网站。用您的网站的所需名称替换为“ mysite”。
步骤3:导航到网站目录
- 通过运行
cd mysite
更改到网站目录。
步骤4:在本地提供网站
- 通过运行
bundle exec jekyll serve
或jekyll serve
启动本地开发服务器。 - 打开您的网络浏览器并访问
http://localhost:4000
,查看您的Jekyll网站在本地运行。
步骤5:自定义网站
- 在您选择的文本编辑器中打开站点目录。
- 探索目录结构,其中包括
_layouts
,_posts
,_includes
等文件夹。 - 通过修改
_config.yml
文件来自定义网站的配置。 - 通过编辑
_layouts
文件夹中的文件来修改网站的布局。 - 通过将Markdown或HTML文件添加到Root Directory或
_pages
文件夹来创建新页面。
步骤6:创建博客文章
- 在
_posts
文件夹中,创建一个带有文件名的新文件,遵循格式YYYY-MM-DD-post-title.md
。 - 在文件开头添加必要的YAML前部件,指定布局,标题,日期和其他元数据。
- 使用Markdown或HTML编写您的博客文章内容。
步骤7:构建网站
- 准备部署网站后,通过运行
bundle exec jekyll build
或jekyll build
进行构建。 - 此命令将在
_site
文件夹中为您的网站生成静态HTML文件。
步骤8:部署网站
- 将
_site
文件夹的内容上传到您的Web服务器或托管提供商。 - 如果您使用的是github页面,则可以将网站的源代码推向存储库,并在存储库设置中启用github页面。
您也可以将jekyll forms添加到静态网站。
就是这样!您已经完成了基本的Jekyll教程。从这里开始,您可以继续自定义网站,探索Jekyll的功能,并结合其他插件和主题以增强您的静态网站。请记住要查阅官方的Jekyll文档(https://jekyllrb.com/docs/)以获取更多详细信息和高级用法。