octojekyll

第1部分这个系列是我使用一些真棒工具和可用的平台今天向您介绍了开源博客。我也分享我自己的设置,以便你可以看到什么是介入终端到终端。

很快,我将提供一个详细的演练,您需要开始与您自己的博客网站。

本地博客发展

首先,我们需要设置我们的本地开发环境,通过安装一些依赖博客网站。

  • 正如我运行一个表面书2这些说明是针对Windows 64位操作系统,但可以根据需要修改,以适应的MacOS或Linux。

开源博客第2部分

第2部分部署计划

接下来…

  • 我们将安装VSCode
  • 我们将安装Git
  • 我们将安装红宝石变身怪医
  • 我们将克隆一个杰奇主题到本地文件夹和预览网站

是否已经安装了Visual Studio代码或Git ?- >更新到最新的版本之前,继续与本指南。

  • VSCode - 进入帮助>检查更新从VSCode客户端更新到最新版本。
  • Git的 - 使用git更新要么git的更新混帐的窗口从Git的客户端更新到最新版本。

第1步 - 安装Visual Studio代码

  1. https://code.visualstudio.com/download
  2. 下载并运行Windows (x64)安装程序~ 57MB。
  3. 在安装向导期间接受所有默认设置。没有什么激动人心的!

第2步 - 安装的Git

  1. 用自己的方式https://git-scm.com/downloads
  2. 下载并运行Windows (x64)安装程序~ 44MB。
  3. 在安装向导 - 请务必选择Visual Studio代码作为Git的默认编辑器从下拉列表(如下所示)。
  4. 所有其他的默认安装看起来都可以保持原样!
Git的安装向导

一定要选择Visual Studio代码为Git的默认编辑器

步骤3 -安装Ruby / Jekyll

  1. https://rubyinstaller.org/downloads/
  2. 下载和运行红宝石+ 2.6.X的devkit(x64)的安装程序〜132MB。
  3. 在安装向导接受所有默认值。
  4. 点击在安装向导的完成。
  5. 安装向导后,一个新的cmd窗口将自动出现,并显示3x选择-确保键入数字1输入接着说。
  6. 如果一切顺利,您应该会看到一个屏幕,上面显示安装了MSYS2。请随意关闭它。
  7. 现在结束了,打开你的VSCode客户端和一个新的终端(ctrl+shift+ ')
  8. 接下来我们需要安装变身怪医捆绑RubyGems的有以下cmdlet:
    $ gem安装jekyll bundler
  9. 如果您遇到的问题在这里尝试重新安装红宝石+的devkit从上述步骤2开始。
Ruby安装程序

下载并运行Ruby+Devkit 2.6。X (x64)安装程序

RubyInstallerWizard1

在安装向导接受所有默认值。

RubyInstallWizard2

在安装向导接受所有默认值。

RubyInstallWizard3

点击完成。

RubyInstallWizard4

按下回车键继续前务必根据需要对数字1键。

RubyInstallWizard5

如果一切顺利,您应该会看到一个屏幕,上面显示安装了MSYS2。请随意关闭它。

JekyllInstall1

我们需要安装哲基尔和捆扎机RubyGems的有以下cmdlet:
$ gem安装jekyll bundler

JekyllInstall2

如果您遇到的问题在这里尝试重新安装红宝石+的devkit从上述步骤2开始。

第4步 - 使用社区主题 - 最小误区

我们希望今天就开始写博客,而不是下周或一个月后。所以让我们克隆/叉现有的杰基尔主题,我们当地的开发环境。然后,我们可以修改它来满足我们的需要,而不重新发明轮子!

顺便说说!默认的化身主题是最小值而且似乎罚款概念的快速证明。我不建议相对于其他的主题时,在那里去,因为它缺乏的程度了。你可以通过执行从VSCode终端以下cmdlet检查出来:

$ jekyll new my-awesome-site $ cd my-awesome-site $ bundle exec jekyll服务

服务成功后—浏览http://localhost:4000将显示这样的主页。

JekyllMinimaTheme

杰奇默认主题(最小值)

目前我使用的最小误区由迈克尔·罗斯,因为它适合我的需要和迈克尔,因为公司提供有用的文档 - 例如退房https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/

开始使用的最小误区主题是最快的方法git的克隆要么混帐叉下面GitHub的库之一。

让我们看看它是如何与远程的主题

尝试执行从VSCode终端以下cmdlet:

$ cd:/ $ git克隆https://github.com/mes/mm-github-pages-starter $ cd mb -github-pages-starter/ $ bundle exec jekyll serve

服务成功后—浏览http://localhost:4000将显示这样的主页。

JekyllTheme1

杰奇社区主题(Mmistakes)

打开新创建的文件夹C:\毫米github上的页面起动从VSCode访问以下站点结构。

JekyllTheme2

Mmistakes网站结构

这里是你在上面看到的细分。了解这个结构很重要,因为您的大多数更改将在这里发生。

  • _数据包含控制网站导航.yml文件在页面顶部链接可见。在添加/删除页面到您的网站修改navigation.yml文件。
  • _pages包含使用的网站,如404和关于网页.markdown文件。修改此文件夹中现有的页面或创建新的满足您的需求。
  • _post包含发布到该网站的新职位.markdown文件。把你的新职位到这个文件夹。
  • _现场正是杰基尔已建成并在本地发布之前存储的网站。您可以忽略此文件夹中。
  • 资产\图片包含站点和页面/帖子使用的图像文件。将您的PNG/JPEG/BMP/GIF文件保存到此文件夹,并在您的标记中引用该路径。
  • _config.yml是主要的配置文件杰基尔引用建立的网站已使用后束EXEC杰基尔服务。首先修改这个文件以更新键属性/变量,然后重新运行一个jekyll服务来查看本地的更改。
  • .gitignore包含不希望通过Git同步到GitHub存储库的文件或文件夹。如果您稍后添加了一个_drafts文件夹来处理不想同步到GitHub中的文章,请修改这个文件。
  • Gemfile是用来定义已加载的网站的RubyGems。根据需要更改插件修改此文件。
  • Gemfile.lock是哲基尔自动生成所显示的文件已使用后束EXEC杰基尔服务- 你可以忽略它。
  • index . html定义了一些YAML前页该网站的主页。有没有需要修改这个文件。
  • README.md是一个有用的介绍由作者迈克尔·罗斯编写的远程主题。

下一步

  • 审查和更新Config.yml
  • 创建一些博客文章到_post文件夹中。
  • 添加您自己的图片进入资产\图片文件夹,并使用它们引用到的帖子! [% ImageDescription %](文件名/资产/图片/ % %)
  • 创建自己的关于页面或更新现有的_pages / About.md
  • 束EXEC杰基尔服务看看结果!

概括

我们已经完成安装我们的开源博客依赖我们当地的开发环境和克隆/服化身主题。

Part2DeploymentComplete

第2部分部署计划完成!

祝贺你走到这一步!

和我一起第3部分这个系列赛里,我们来看看把你的博客住在一起GitHub上GitHub的页面

干杯,杰西

类别:
微软技术教育大会未分类
标签: