问题标签 [gitbook]

我创建了一个 gitbook 帐户并处理文档，我在将我的工作转换为格式（pdf、mobi 和 epub）时遇到了一些困难。帮帮我 。我有我工作的链接，但如何将其转换为格式

我正在构建一个 bookdown 项目并将其呈现为具有大量数学页面的 gitbook，并且呈现缓慢。我想使用KaTeX而不是 mathJax 来呈现我的数学，但我不知道如何让它工作。有一个gitbook 插件，所以应该可以，但我不太清楚如何将它与 bookdown 集成。

在我的index.Rmd文件中，我尝试了以下方法：

其中katex.html包括 KaTeX 的样式表和主题。

然而，数学并没有被渲染（除了一些仍然由 MathJax 渲染的部分）。

有什么方法可以让我与 KaTeX 一起工作吗？

将 1 个图像和文本居中到全宽。 https://coderwall.com/p/iftc1q/centered-text-and-images-in-github-markdown

具有相同功能的插件 https://github.com/todvora/gitbook-plugin-image-captions

AsciiDocTOR 关于该问题的讨论： https ://github.com/asciidoctor/asciidoctor/issues/857

我尝试使用 gitbook 做一本……书。但多次我在单行/行上有 4 张图像，即彼此并排。带有需要在每个图像下方居中的标题/标题/说明。有什么方法可以通过混合一些 html/css 技巧来实现？有任何想法吗？谢谢你。

介绍

因此，我正在构建一门课程，该课程由教科书（一组 Markdown 文件）、一些示例代码（用于家庭作业和项目）和幻灯片（现在在 Google 幻灯片中）组成。

教科书是使用名为 GitBook 的 Markdown 发布工具发布的，它允许我使用 GitHub 来托管所有 Markdown 文件，并自动将它们编译成漂亮的样式 Web UI 以供阅读。它还允许以特定方式包含该书的翻译版本，以便以多种语言阅读。

目前，这本书托管在两个独立的 Github 存储库中，一个用于概念（或讲座），一个用于实践（实验室练习）。

该代码还存储在两个 Github 存储库中：解决方案代码和入门应用程序。

这些幻灯片目前都在谷歌幻灯片上。

问题

我希望组织（或重新组织）本课程，考虑到以下几点：

1. 课程需要模块化。它将在许多不同的环境中教授，有些非常彻底，有些很短。这意味着我想以某种方式标记课程的不同部分，以便我可以将课程的不同版本组合在一起（也许三天的版本只包括基础知识，但为期一周的研讨会可能包括额外的模块）。理想情况下，我可以对教科书、代码和幻灯片使用相同的标记，这样我就可以自动将正确的“包”组合在一起。

2. GitBook 需要存储库中的特定文件结构，所以我不能在那里进行太多更改。

3. 这些幻灯片目前甚至不在存储库中，因为它们是 Google 幻灯片格式，但是将它们移动到同样的位置会非常棒，因为所有东西都可以放在一个地方（也许还有某种 Markdown？必须转换它）。

我试过的

我不确定从哪里开始组织所有这些内容，我正在考虑将所有内容都移到一个存储库中，并使用子模块来保持事物的组织性，但我对此没有太多经验。

还考虑过为不同的版本使用不同的分支，但这似乎会增加大量工作，因为如果有共同的文件，我必须在发生更改时独立更新每个分支。

也想到了标签，但由于这些标签是提交而不是文件，不确定这会有什么帮助。

有什么建议么？工具？想法？

提前致谢， 尼基塔

我遇到了一个问题。
我运行命令“gitbook pdf”，它显示了这个错误：

EbookError：生成电子书时出错：1% 正在将输入转换为 HTML...
InputFormatPlugin：HTML 输入
在 /tmp/tmp-72206AoHgIzetV6D/SUMMARY.html 上运行
未指定语言 未指定
创建者
构建文件列表...
规范化文件名案例
重写 HTML 链接
34% 在电子书上运行转换...
合并用户指定的元数据...
检测结构...
检测到的章节：简介
检测到的章节：CH1
检测到的章节：CH2
检测到的章节：项目 1
自动生成的 TOC 有 4 个条目。
扁平化 CSS 和重新映射字体大小...
无法解析 CSS 选择器：u'h|button::-moz-focus-inner'
无法解析 CSS 选择器：u'h|input::-moz-focus-inner'
无法解析 CSS 选择器：u'h|input[type=search]::-webkit-search-cancel-button'
无法解析CSS 选择器：u'h|input[type=search]::-webkit-search-decoration'
源基本字体大小为 12.00000pt
删除假边距...
清理清单...
从清单中修剪未使用的文件...
创建PDF 输出...
67% 正在运行 PDF 输出插件
Traceback（最后一次调用）：
File "/usr/bin/ebook-convert", line 20, in<br> sys.exit(main())
File "/usr/lib/calibre/calibre/ebooks/conversion/cli.py", line 359, in main<br> plumber.run()
File "/usr/lib/calibre/calibre/ebooks/conversion/plumber.py", line 1189, in run self.opts, self.log)
File "/usr/lib/calibre/calibre/ebooks/conversion/plugins/pdf_output.py", line 123, in convert
must_use_qt()
File "/usr/lib/calibre/calibre/gui2/__init__.py", line 1041, in must_use_qt raise RuntimeError('X server required. If you are running on a' RuntimeError: X server required. If you are running on a headless machine, use xvfb

错误是什么意思？

如何在Gitbook中进行 google 验证所有权站点，例如将站点地图上传到 Google？

谷歌解释了许多技术。显然，最简单的方法是将 HTML 文件上传到主文件夹页面：https ://support.google.com/webmasters/answer/35179?hl=en

问题是 gitbook 不会以这种方式上传文件：www.mygitbooksite.com/googleVerificacion4341321.html. 但是可以在文件夹中添加：www.mygitbooksite.com/someFolder/googleVerificacion4341321.html

我找到了一个与解决方案相关的 gitbook 插件：https ://www.npmjs.com/package/gitbook-plugin-verifications

我进行了很多搜索，但没有运气进行此验证，仅在如何添加谷歌分析方面。

提前致谢！

如何在 GitBook 中显示这样的原始代码？

我相信这与： 从 GitHub 读取代码作为网页中的文本（原始） 但我不知道如何调用主文档中的 JavaScript 函数。

我使用 GitBook 创建了一本书。我希望只有特定的人能够阅读我的书。这些人应该能够通过在某处登录或通过任何其他方法访问它。我将如何实现这一目标？即使链接是公开的，我该如何限制看到它的用户？
（我不想将它们添加到合作者列表中）

我正在尝试将 Gitbook 与 AsciiDoc 一起使用（运行 Win10x64、NodeJS 6.9.1 和 Gitbook v3.2.2）——我对它们都是新手。

Gitbook 文档说从 v2.0.0 开始支持 AsciiDoc，并链接到AsciiDoctor 文档——我检查了节点包，gitbook取决于gitbook-asciidoc哪个又依赖于asciidoctor.js.

根据文档，AsciiDoc 角色可用于设置图像和表格的样式。它们指的是应用于 HTML 元素的类，这些类在默认的 AsciiDoctor 样式表中定义。

但无论我如何尝试应用角色，例如图像（[.text-center]速记或[role="text-center"]，我都没有得到预期的输出（即图像水平居中）。我可以使它适用于图像的唯一方法是设置属性 align="center"，甚至没有记录。

通过检查浏览器中的输出，我可以看到类已应用于 HTML 元素，但没有匹配的 CSS 规则——就我所尝试的而言，表格样式也是如此。

关于 AsciiDoctor 角色和样式表，我在这里缺少什么？

编辑：asciidoctor.js是 devDependencygitbook并且实际上没有与gitbook. AsciiDoc文档align="center"中记录了 ，但表格样式（至少and ）等其他功能似乎不适用于.frame="none"grid="none"gitbook

如果 Gitbook 文档不受支持，我仍然不明白为什么它会链接回 AsciiDoctor 的文档……</p>

after i install the nodejs and npm , gitbook-cli ,there is an error.like this:

my nodejs version and npm are v0.10.48 ,1.3.6 ,what should i do ,please help me .