• 使用gitbook 发布一个教程文档网站


    gitbook是一个好用的发布电子书的项目;使用gitbook 可以在本地写好文档再远程推送到库;也可以在gitbook提供的在线平台上制作电子书;要想在自己的服务器上使用gitbook 发布一个网站;则需要相应的运行环境。本文是通过gitbook editor 软件写好电子书的项目;然后通过WinSCP上传到服务器;再通过gitbook serve 解析MarkDown文档,监听本地4000端口实现的。

    1、运行环境:

    LINUX; CentOS平台 ; nodejs;npm;

    2、安装配置:

    配置很简单;安装nodejs:

    yum install nodejs

    npm 是nodejs自带的包管理工具;使用yum安装 nodejs 默认安装npm;

    3、安装gitbook:

    使用命令  (全局安装)

    npm install -g gitbook-cli  

    4、初始化:

    gitbook init

    会在默认安装gitbook的文件夹初始化一个项目;包含一个README.md 和 SUMMARY.md 两个文件。 默认情况下在这个目录新建文档即可;也可以将写好的整个项目上传到服务器;最后使用gitbok解析即可;我们选择后者;

    5、解析新项目:

    新项目上传到服务器后;找到项目路径:

    cd /usr/share/nginx/gitbook

    新项目的名称位于gitbook文件夹下;名称为javascript;

    gitbook serve javascript

    运行结果:

    默认 监听本地的4000端口;可以使用服务器的ip(公网ip)访问这个项目;gitboo会解析Markdown文档;并返回html页面。

    因为http默认协议使用的是80端口;使用默认的url链接是无法访问的;必须要在后面加上端口号;类似于  http://localhost:4000/;   非常不好看; 但是我们可以通过web服务器Nginx、 Apache;开启端口转发。将80端口的请求转发到4000端口。

     

  • 相关阅读:
    request内置对象
    JSP页面、包含
    HTTP协议
    html简介
    数据访问层工具类
    数据运算
    可变于不可变对象分类
    有序 无序 的区别
    字符串方法
    day01_final
  • 原文地址:https://www.cnblogs.com/engeng/p/8135437.html
Copyright © 2020-2023  润新知