用高架创建自己的野蛮人

作为开发商，我们的成就大小，为我们的专业成长做出了重大贡献。但是，在其他任务中，这些成就通常没有引起注意，失去了。瑞安·T·哈特（Ryan T. Harter）在他的演讲中描述的那样，这项“看不见的工作”很容易被遗忘，尤其是在表演评论中。

朱莉娅·埃文斯（Julia Evans）关于维护“吹牛文件”的文章提供了解决方案。吹牛文件只是您宝贵贡献的记录，包括项目参与，对同事的帮助，过程改进，演示，讲习班，学习经验，课外活动（博客，个人项目），奖项和职业发展。

尽管存在用于创建吹牛文档的各种工具，例如Br​​agdocs.com，但构建自己的构建提供了更大的自定义。该教程演示了如何使用静态站点发电机高度重新创建类似bragdocs.com的位点。使用最小的JavaScript和CSS，您可以构建自己的个性化吹牛文档。

构建您的吹牛文件

该教程的结果反映了Bragdocs.com，为您自己独特的吹牛文档提供了基础。现场演示可以在这里使用。

先决条件

• Node.js（版本10或更高版本）和NPM。
• 熟悉HTML和CSS。
• 了解Markdown，Nunjucks模板和JavaScript（有用但并不是严格要求）。
• 基本的编程概念（如果语句，循环，访问JSON变量）。

高度介绍

高度是静​​态站点发生器。与全栈开发不同，它允许使用各种模板语言（HTML，Markdown，Liquid，Nunjucks等）创建灵活的内容。高架流程此内容，生成静态HTML页面，以方便托管。

设置您的高度项目

本教程使用了高度的存储库。

1. 项目创建：使用README.md创建一个GitHub存储库（例如， eleventy-bragdoc ）和一个.gitignore文件。

2. 初始化：导航到您的终端中的eleventy-bragdoc目录并运行： npm init -y这将创建一个package.json文件。

3. 高度安装：安装高度： npm install @11ty/eleventy

4. 配置（ package.json ）：更新package.json的scripts部分：

 {
  // ...
  “脚本”：{
    “ start”：“高度 - 服务”，
    “构建”：“高度”
  }，，
  // ...
}

5. 高架配置文件（ .eleventy.js ）：创建一个.eleventy.js文件以指定输入和输出目录：

模块。Exports= function（leventyConfig）{
  返回 {
    dir：{
      输入：“ SRC”，
      输出：“公共”
    }
  }
}

6. 内容创建：创建src目录并添加index.md文件（您的首页）。高度支持各种模板语言；此示例使用Markdown。

7. 模板创建：创建src/_includes/layouts目录并添加base.njk文件（使用nunjucks的基本模板）。

8. 连接CSS和图像：创建src/css和src/images目录。更新.eleventy.js ：

模块。Exports= function（leventyConfig）{
  everconfig.addwatchtarget（“ ./ src/css/”）
  enventyconfig.addwatchtarget（“ ./ src/images/”）
  enventyconfig.addpassthroughcopy（“ ./ src/css/”）
  enventyconfig.addpassthroughcopy（“ ./ src/images/”）
  // ...
}

其余步骤详细介绍了Bragdoc功能的构建，包括收集，数据处理，样式和部署。每个步骤的完整代码和详细说明都可以在原始文本中获得。

以上是用高架创建自己的野蛮人的详细内容。更多信息请关注PHP中文网其他相关文章！