项目结构

  • 文件系统约定

    • init命令自动生成的两个必备文件
      • README.md 书籍引言(前言、简介)
      • SUMMARY.md 目录结构(大纲)
    • 手动生成
      • LANGS.md 多语言书籍
      • GLOSSARY.md 术语表(词汇解释)
      • book.json 配置信息
      • en/ 英文内容目录
      • zh-hans/ 简体中文目录
      • _book/ 输出路径
      • .gitignore、.bookignore、.ignore过滤文件或文件夹
      • 静态文件和图片:SUMMARY没列出的文件,编译时直接复制
  • 目录结构

          ├── book.json
          ├── README.md
          ├── SUMMARY.md
          ├── chapter-1/
          | ├── README.md
          | └── something.md
          └── chapter-2/
          ├── README.md
          └── something.md
    
    • 作为项目文档

      • 对于软件项目,可用文件夹放置图书内容,只需在book.json文件中指定root配置即可配置book.json

              {
                  "root": "./docs"
              }
        
      • 对应目录结构

          ├── book.json
          └── docs/
              ├── README.md
              └── SUMMARY.md
        
  • _book静态网站

    • index.html语言索引目录
    • search_index.json搜索索引描述
    • gitbook/页面脚本、资源以及样式表
    • en/英文内容页面
    • zh-hans简体中文内容页面
  • LANGS.md语言

    [中文](zh-hans/)
    [English](en/)
  • GLOSSARY.md术语
    • 术语为二级标题,只支持英文术语
    • 书籍中只要出现术语,GitBook都会为其自动生成索引,指向注释页glossary.html
  • SUMMARY.md大纲

    • 格式:章的名称
    • 编辑后,使用$ gitbook init生成对应目录和文件

      a. 小篇幅:

            * [简介](README.md)
            * [第1章](c1.md)
                - [第1节](c1s1.md)
                - [第2节](c1s2.md)
            * [第2章](c2.md)
      

      b. 大篇幅

            * [简介](README.md)
            * [第一章](chapter1/README.md)
                - [第一节](chapter1/section1.md)
                - [第二节](chapter1/section2.md)
            * [第二章](chapter2/README.md)
                - [第一节](chapter2/section1.md)
                - [第二节](chapter2/section2.md)
            * [结束](end/README.md)
      

      c. 分割

            ### Part I
            * [Writing is nice](part1/writing.md)
            * [GitBook is nice](part1/gitbook.md)
            ### Part II
            * [We love feedback](part2/feedback_please.md)
            * [Better tools for authors](part2/better_tools.md)
      
  • 封面

    • 尺寸
      • cover.jpg 1800x2360
      • cover_small.jpg 200x262
    • 好的封面准则:
      • 没有边框
      • 清晰可见的书本标题
      • 任何重要的文本在小版本中可见
  • SEO:

    • 文件顶部添加如下格式描述内容,可实现SEO优化

            ---
            description: 页面描述内容
            ---
      
    • 描述内容不会呈现,而是编译到页面的 meta 标签中。

Copyright © zhilidali 2016 all right reserved,powered by Gitbook该文件修订于: 2016-12-07 21:08:36

results matching ""

    No results matching ""