zoukankan      html  css  js  c++  java
  • gitbook操作

    上一篇介绍了gitbook的安装和部署,本节介绍一下gitbook的操作;主要包括:

    • md文件的新建和编辑;
    • gitbook目录结构的设计;

    1、md文件的新建和编辑

    1)新建md文件

    通过typora软件新建文件,文件名称:使用简介.md

    2)编辑

    右键菜单,可选择段落标题和插入的内容(包括:代码、图像、表格等)

    插入图片:

    图片路径:

    /usr/local/gitbook/images/gitbookVersion.png,其中/usr/local/gitbook为gitbook服务的目录,在插入图片时,内容可省略,插入图片格式如下:

    ![](/images/gitbookVersion.png)

     2、gitbook目录设计

    1)在创建md文件存放目录

    在/usr/local/gitbook目录下新建目录,目录名称自定义,例如:md

    mkdir md

    2)编辑好的md文件(README.md)置于md目录下

    README.md文件内容如下:

    # 一、gitbook使用简介
    
    GitBook是一个命令行工具(和Node.js库),用于使用GitHub / Git和Markdown(或AsciiDoc)构建精美的书籍;[gitbook](https://www.gitbook.com/) 的默认语法就是markdown,能够很好的展现你的内容,并且排版都不需要你担心,在此基础上,会自动生成目录、父子级、划分列表,让你把所有的精力都放在内容,还可以直接部署在互联网上;markdown文件的格式为.md,可通过文本编辑器直接打开和编辑,常用Typora软件来编辑;
    
    # 二、安装部署
    
    ## 2.1、nodejs安装部署
    
    1)下载
    
    ```
    wget http://cdn.npm.taobao.org/dist/node/v10.16.0/node-v10.16.0-linux-x64.tar.xz
    ```
    
    2)解压
    
    ```
    tar -xvf node-v10.16.0-linux-x64.tar.xz
    ```
    
    3)重命名
    
    ```
    mv node-v10.16.0-linux-x64 nodejs
    ```
    
    4)移动到/usr/local目录
    
    ```
    mv nodejs /usr/local
    ```
    
    5)建立软链接(为node和npm建立软链接,确保node和npm命令能直接使用)
    
    ```
    ln -s /usr/local/nodejs/bin/node /usr/bin/node
    ln -s /usr/local/nodejs/bin/npm /usr/bin/npm
    ```
    
    6)安装验证
    
    ```
    node -v
    ```
    
    成功安装可显示nodejs版本号;
    
    ## 2.2、gitbook安装
    
    1)安装gitbook-cli
    
    ```
    npm install gitbook-cli -g
    ```
    
    2)建立软链接(为gitbook建立软链接)
    
    ```
    ln -s /usr/local/nodejs/bin/gitbook /usr/bin/gitbook
    ```
    
    3)安装验证
    
    ```
    gitbook -V
    ```
    
    安装成功,输出gitbook版本号,显示结果如下:
    
    ![](/usr/local/gitbook/_book/gitbook/images/gitbookVersion.png)
    
    ## 2.3、gitbook启动
    
    执行命令:
    
    ```
    gitbook serve
    ```
    
    输出结果:
    
    ![](/usr/local/gitbook/_book/gitbook/images/gitbookStart.png)
    
    ## 2.4、浏览器访问
    
    在浏览器输入访问地址:http://172.16.79.151:4000/
    
    页面展示如下:
    
    ![](/usr/local/gitbook/_book/gitbook/images/page.png)

    3)编辑SUMMARY.md文件

    # Summary
    
    * [0-使用简介](md/README.md)

    4)编译

    执行编译命令:

    gitbook build

    5)启动

    执行启动命令:

    gitbook serve

    6)浏览器访问

    浏览器输入地址:http://172.16.79.151:4000

     

     

  • 相关阅读:
    python实现的最近最少使用算法
    GreaseMonkey渐进
    SICP 与函数式编程
    python实现的简单的epub2txt
    智能去除选定区域
    ubuntu下svn上传到google code
    视频数据编解码技术
    分享三个好用的装饰器
    ubuntu下访问E72
    如何组织文件
  • 原文地址:https://www.cnblogs.com/wzl0916/p/13692228.html
Copyright © 2011-2022 走看看