使用github写一本书[关闭]

2023-12-30

使用 Github,我们可以编写格式良好的 README.md 文件和文档来展示项目。此外,还有供用户协作的 wiki 页面。我正在思考什么是最佳工作流程,即使对于非技术用户来说也是如此,利用 GitHub 平台编写协作书籍。

如何使用 Markdown,然后通过应用样式表来增强它、将其制作为 PDF、组织章节、建立公共站点(gh-pages)等等? GitHub有这样的项目或者工具链吗?

换句话说,如何在 GitHub 中轻松编写一本具有良好 html 和 PDF 输出的协作书籍?谢谢。


Edit:自从我第一次写这个答案以来,GitBook 已经发生了很大的变化。 PDF 支持已被删除,CLI 工具链已被放弃,取而代之的是专有服务 https://github.com/GitbookIO/gitbook/blob/master/README.md:

由于 GitBook 团队的工作重点是 GitBook.com 平台,因此 CLI 不再处于积极开发状态。

2019年中mdBook https://rust-lang-nursery.github.io/mdBook/是一个不错的选择,尽管它本身不支持 PDF。如果你安装了 Rust 和 Cargo,你可以简单地

cargo install mdbook

开始。


原答案:

这正是GitBook https://github.com/GitbookIO/gitbook专为:

GitBook 是一个命令行工具(和 Node.js 库),用于使用 GitHub/Git 和 Markdown(或 AsciiDoc)构建精美的书籍。

It 支持PDF输出 http://toolchain.gitbook.com/ebook.html开箱即用,以及在线发布自己的网络平台 https://www.gitbook.com/.

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

使用github写一本书[关闭] 的相关文章

随机推荐

  • 如何在 Angular 1.5 组件中等待 UI Router Resolve 的承诺

    我正在使用 Angular 1 5 组件 我不知道如何通过 Resolve 获取数据 您能透露一些信息吗 Plunker https plnkr co edit 2wv4YWn8YQvow6FDcGV0 https plnkr co edi
  • Openlayers 3. 如何为功能制作tootlip

    现在我正在将我的项目从 openlayers 2 移动到 openlayers 3 不幸的是 我找不到如何显示功能的标题 工具提示 OL2中有一种风格叫graphicTitle 您能给我一些如何在 OL3 上实现工具提示的建议吗 这是 ol
  • 元素在类中没有匹配项

    我正在使用 Simple XML 框架 只是重命名了一些 XML 布局 但现在它们似乎不再起作用了 这是我的 XML
  • 将多个帧发送到AWS rekognition

    我正在尝试从我的网络摄像头将图片发送到 aws rekognition 以使用 python 检测坐在它前面的人的活动 为此 我每 5 秒拍一张照片并将其发送到 aws 但当我这样做时 他似乎总是发回有关我发送的第一帧的信息 cap cv2
  • 防止缓存 CSS 文件

    我正在使用 PHP 开发一个简单的网站 开发配置 WAMP 生产配置 LAMP 在测试时 我更改了 CSS 文件 但是当我重新加载页面时 我的浏览器 不确定 仍然使用旧的缓存 css 我做了一些谷歌搜索 发现了我已经尝试过的不同解决方案 在
  • Android开发字符串数组资源太大,导致Android应用程序崩溃!

    我有一个字符串数组资源 其中包含大约 1000 个药物名称
  • 在 PowerShell 中使用 WinSCP 仅下载新文件

    如何下载最新文件或某天发布的文件 导入包含以下内容的 CSV 文件Source and a 目的地柱子 需要检查路径是否存在 文件是否存在并且仅下载新文件 现在的脚本正在将所有文件移动到相应的文件夹 但是一旦我再次运行脚本 它不仅仅下载新文
  • 强制转换为“void”到底有什么作用? [复制]

    这个问题在这里已经有答案了 经常使用的语句 例如 void x 允许抑制有关未使用变量的警告x 但是如果我尝试编译以下内容 我会得到一些我不太理解的结果 int main int x short x void x int x 用 g 编译它
  • CBCentralManager 连接是否超时?

    我知道答案名义上是 不 但我的意思是really 如果应用程序进入后台 启用 BTLE 后台处理 会怎样 24小时 跨应用程序更新 在 重新连接到外围设备 标题下 苹果文档 https developer apple com library
  • 当需要 getter 和 setter 方法时如何在 Python 模块之间共享变量

    如果我需要这些变量具有 setter 和 getter 方法 如何在 Python 项目的不同模块之间共享变量 我需要 setter getter 方法的原因是 在获取和设置变量时 我需要与将这些变量存储为环境变量的代码向后兼容 所以我也需
  • java.sql.SQLException:未知的系统变量“query_cache_size”

    我有一个使用 JDBC 运行的应用程序并从 MySQL 获取数据 但由于以下错误我无法构建它 java sql SQLException Unknown system variable query cache size at com mys
  • 当我在 Project Explorer 中选择文件时,如何让 Eclipse 自动打开/预览文件

    当我在 Project Explorer 中选择文件时 有没有办法让 Eclipse 自动打开 预览文件 我知道我可以双击 但我想在探索项目时快速向上 向下箭头 我本质上是在寻找 Mac Finder 快速查看或 Windows 7 资源管
  • 如何检索给定相对路径的绝对路径

    是否有命令可以检索给定相对路径的绝对路径 例如我希望 line 包含 dir 中每个文件的绝对路径 etc find type f while read line do echo line done Try realpath sudo ap
  • jquery div 是否包含某个类的子级

    我有一个事件处理程序 它触发一个事件处理程序 该事件处理程序需要测试 div 的子级是否包含某个类 现在 我正在这样做 Container DivData live mouseenter function if this find Hidd
  • 类型“typeof StoreModule”上不存在属性“provideStore”

    我认为他们发布了一些重大更改 这是我收到的错误消息 类型 typeof StoreModule 上不存在属性 provideStore 我用谷歌搜索了这个错误消息 但没有找到任何东西 尽管如此 我猜还是有一些我不知道的 API 更新 有人能
  • .net core 跨平台桌面应用

    我想使用 net Core 开发一个跨平台桌面应用程序 该应用程序需要在 Linux Mac os 和 Windows 上执行 为此 我应该创建一个控制台应用程序并将以下行放入设置 xml 中吗
  • 如何在 C# 中通过 FileStream 和 ResumableUploader 上传/更新文件

    我想通过 Google Documents List API C 中的 System IO FileStream 上传 更新文件 我使用以下两种方式 Google GData Client ResumableUpload Resumable
  • 如何在 Eclipse EE Luna 中分析 Java Web 应用程序 servlet 调用

    在我的 Web 应用程序中 servlet 甚至在开始写入响应之前也需要几秒钟的时间 我想知道 servlet 执行期间调用了哪些方法以及每个方法花费的时间 Luna 版本中是否已包含分析器面向 Java EE 开发人员的 Eclipse
  • 如何使用TableAdapter进行更新?

    我正在写一个程序WindowsApplication其中使用数据库 我显示数据库值DataGridView 目前 我希望可以通过以下方式更新数据库DataGridView 因此我写了这段代码 private void MainForm Lo
  • 使用github写一本书[关闭]

    Closed 这个问题需要多问focused help closed questions 目前不接受答案 使用 Github 我们可以编写格式良好的 README md 文件和文档来展示项目 此外 还有供用户协作的 wiki 页面 我正在思