美文网首页
windows 系统下GitBook环境搭建与使用教程

windows 系统下GitBook环境搭建与使用教程

作者: 关爱单身狗成长协会 | 来源:发表于2017-02-25 15:47 被阅读2524次

    1.搭建Nodejs环境

    前往Node.js官网
    下载最新版Nodejs windows系统安装包
    安装成功后再cmd窗体中输入node -v 查看是否安装成功
    参考资料

    2.安装 GitBook 可视化编写工具

    下载GitBook Editor windows版
    安装成功后桌面会有个gitbook图标
    双击打开查看是否安装成功:

    运行效果

    点击最下面** Do that later **可不用登陆进入主界面

    3.安装gitbook

    在任意目录下运行cmd控制台 输入:npm install gitbook-cli -g 进行安装

    4.配置gitbook目录

    在GitBook Editor界面菜单中找到Change Library Path..来改变工作路径
    (比如在:F:\GitBook Editor files)

    示例

    5.创建测试项目

    比如创建项目test点击Confirm创建

    示例

    创建成功后找到SUMMARY.md

    相关说明:README.md 和 SUMMARY.md 是两个必须文件
    README.md 是对书籍的简单介绍
    SUMMARY.md 是书籍的目录结构

    创建成功

    点击右下角 问好 对 Edit Markdown选项打钩

    示例

    输入示例内容:

    #Summary
    
    * [Introduction](README.md)
    * [第一章](chapter1/README.md)
    * [第一节](chapter1/section1.md)
    * [第二节](chapter1/section2.md)
    * [第二章](chapter2/README.md)
    * [第一节](chapter2/section1.md)
    * [第二节](chapter2/section2.md)
    * [结束](end/README.md) 
    
    输入示例内容

    然后切换到项目目录中
    (比如:F:\GitBook Editor files\Import\test)
    按住Shift 然后点击鼠标右键


    示例

    打开cmd窗体后
    输入:gitbook init进行初始化

    示例

    初始化完成后目录会多出几个文件夹(这时GitBook Editor可能会提示重新加载项目,点击蓝色按钮进行加载就可以了)


    示例

    然后
    输入:gitbook serve命令运行查看效果

    示例

    然后在浏览器中访问http://localhost:4000进行访问

    http://localhost:4000

    6.接下去写自己的文章或说明文档啥的吧

    示例 示例

    关于图片,你可以在项目下创建assets文件夹将资源丢在assets文件夹中 然后可以多拽 或手动引入

    7.其他

    其实还有更加方便的使用,就是你可以直接通过 gitbook editor 创建好项目后通过gitbook buildgitbook serve命令运行编译,后直接把编译好的目录下有个 _book 拷出来 放在自己的服务器上

    相关文章

      网友评论

          本文标题:windows 系统下GitBook环境搭建与使用教程

          本文链接:https://www.haomeiwen.com/subject/qvxnwttx.html