比原链开发文档

gg 3月前 136

目录结构

导航(中文 .cn)

_data/topnav.yml 可配置

侧边栏(中文 .cn)

  • 1.主页侧边栏 mydoc_sidbar_cn.yml

    • 可设置title / url
    • URL中文状态下必须为.cn.html 比如:/mydoc_introduction.cn.html

  • 2.新闻侧边栏 home_sidebar_cn.yml

    • 可设置title / url
    • URL中文状态下必须为.cn.html 比如:/mydoc_introduction.cn.html

内容添加(中文 .cn)

  • 1.主页侧边栏对应内容页

    (比如 _data/sidebar/mydoc_sidbar_cn.yml 里的 mydoc_introduction.cn.html 对应 pages/mydoc/mydoc_introduction.cn.html)

  • 2.新闻侧边栏对应内容页

(_data/sidebar/home_sidbar_cn.yml 里的.cn.html 对应 pages/mydoc/.cn.html)

启动

安装本地Jekyll环境步骤:

  • 1.安装ruby

  • 2.打开终端,执行sudo gem install jekyll

如果是在淘宝的镜像,可能找不到Jekyll

ERROR:  Could not find a valid gem 'jekyll' (>= 0), here is why:
      Unable to download data from http://ruby.taobao.org/ - bad response Not Found 404 (http://ruby.taobao.org/latest_specs.4.8.gz)

更换镜像:

gem source -r https://ruby.taobao.org/ (移除淘宝镜像)
gem source -a https://rubygems.org/ (添加新镜像)

查看当前镜像:gem source,出现下面输出代表更换成功

*** CURRENT SOURCES ***
https://rubygems.org/

再次执行sudo gem install jekyll,输入电脑密码,等待安装一会。

  • 3.进入到你刚刚下载的Jekyll主体文件目录cd /Users/Joe/Documents/git/Joe-Liuyi.github.io

  • 4.执行bundle install 如果出现提示:

-bash: bundle: command not found

就先安装bundle(执行sudo gem install bundle),再执行此命令,见一堆绿色打印的时候说明执行命令成功。

  • 5.开启Jekyll环境bundle exec jekyll serve,看见下面输出代表开启成功。
liuyideMacBook-Pro:Joe-Liuyi.github.io Joe$ bundle exec jekyll serve
Configuration file: /Users/Joe/Documents/git/Joe-Liuyi.github.io/_config.yml
        Source: /Users/Joe/Documents/git/Joe-Liuyi.github.io
   Destination: /Users/Joe/Documents/git/Joe-Liuyi.github.io/_site
Incremental build: disabled. Enable with --incremental
  Generating... 
                done in 0.528 seconds.
Auto-regeneration: enabled for '/Users/Joe/Documents/git/Joe-Liuyi.github.io'
Configuration file: /Users/Joe/Documents/git/Joe-Liuyi.github.io/_config.yml
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
  • 6.在浏览器输入http://127.0.0.1:4000/,即可访问
最新回复 (0)
全部楼主
    • 比原链BlockChain用户组
      2
        立即登录 立即注册 
返回
发新帖