• gitbook配置


    一、是什么

    明确一点Git 与 GitBook 就像雷锋和雷峰塔完全没有一点关系。

    GitBook 是 一 个 基 于 Node.js 的 命 令 行 工 具 , 支 持 Markdown 和 AsciiDoc 两种语法格式,可以输出 HTML、PDF、eBook等格式的电 子书。所以我更喜欢把 GitBook 定义为文档格式转换工具。目前使用的搭配是 GitBook + Typora + Git。

    二、如何搭建 GitBook 环境?

    因为GitBook 是基于 Node.js,所以我们首先需要安装 Node.js

    1、安装 Node.js 

    下载地址:https://nodejs.org/en/download/

    LTS 版本是一个支持 NodeJS 老版本特性的特殊新版本,Current 版本属于

    一个全新的新版本。如果你的NodeJS 应用使用的比较老的 SDK 开发,LTS 版

    本能让你平滑升级到新版本。

    如果你的NdoeJS 应用使用的是全新的 SDK 开发选择 Current 版本即可。

    2windows 安装

      

    安装结束之后使用cmd 控制台输入node -v 出现版本号则成功、

    如果命令无法找到。则需要配置环境变量。

     

    1、配置环境变量

     

    node.js 的路径加入环境变量,重启控制台重新输出 node -v 即可

    4mac 安装

    1、双击安装程序安装

    如下:

    2、显示程序将会安装的位置

    一直点击继续到最后为

    3、在终端中输入命令

    node –v

    npm –v

    如下:

     

     若展示如上说明node 安装成功

    4、若 node-v 提示为失败

    - bash: node: command not found

    需要配置环境变量了步骤如下

    进入finder 右键选择”前往文件夹”如下

    进入etc

     

     文件夹中找到“profile”文件,此文件锁定可以复制一份出来加上以下语句: 

      export NODE_HOME=" node 安装路径(bin 路径的父级路径)"

      export PATH=$PATH:$NODE_HOME/bin

    步骤2 中已有 node 安装路径为/usr/local/bin/node所以我自己这边增加语句如下:

       export NODE_HOME="/usr/local" export

      PATH=$PATH:$NODE_HOME/bin

      ps:( 如果不记得 node 的安装路径,可以打开终端,输入 which node即可找出node 安装路径 )

    改完profile 副本文件保存为不带后缀的文件,名字亦为profile 即可覆盖原来的 profile,环境变量配置好了就可以按照步骤 3 来验证了。

    2、安装 gitBook

    打开命令行,执行npm install -g gitbook-cli

     

    Gitbook-cli 不能有空格

    安装完成

     

    检验:

    Gitbook -v

    无错误即可

    三、GitBook 如何使用

    1、配置

     1、创建一个文件夹名为 mybook(名字可以随便取)

     2、在控制台上找到这个文件夹并输入gitbook init

      

    安装成功之后,目录下会出现两个文件。

    3、将此文件夹拖拽到 VSCode 中就可以进行吧编辑

     

    SUMMARY.md 为目录超链接文档,语法格式为:markdown 格式。

    小括号内为超链接

    4、点击此按钮为预览

     

    5、编辑成功之后再 cmd 中运行 gitbook serve

     

    浏览器访问如上地址

    6、如果遇到如下问题

     请关闭杀毒软件别问我为什么

    运行成功之后为

     

    7、如果要写文档则需要新建一个 .md 文档将其路径添加到对应的

      SUMMARY.md 的超链接中

    2、未完待续

      ....

  • 相关阅读:
    关于js中event的target和currentTarget的区别
    linux下安装tomcat
    Linux下安装配置JDK
    上传bash: rz: command not found
    Linux忘记 root密码的解决办法
    Linux的关机与重启命令
    windows版本jenkins部署django项目
    Jenkins部署邮件通知
    Jenkins+Ant+Jmeter接口自动化集成测试实例
    postman+jenkins集成
  • 原文地址:https://www.cnblogs.com/ranyihang/p/10760788.html
Copyright © 2020-2023  润新知