zoukankan      html  css  js  c++  java
  • 使用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端口。

     

  • 相关阅读:
    poj 1067||hdu 1527 取石子游戏(博弈论,Wythoff Game)
    CGAffineTransform属性
    自定义UITabBarController
    UISwitch用法:
    UIButton常见属性和方法
    xcode添加背景音乐/音效
    使用cocoaPods加载框架的具体步骤:
    UILabel
    NSString -- UILabel中字体有多种颜色,字符串自动计算高度/换行
    xcode 修改类名 变量名
  • 原文地址:https://www.cnblogs.com/engeng/p/8135437.html
Copyright © 2011-2022 走看看