book的修改工作记录
ProtossProbe opened this issue · comments
由于刚学git，对book的改动可能比较频繁，所以在这里记一下改了些什么地方。
- 把储存在git内的图片链接改回了相对路径，并能正常显示
- 把放错位置的两张图片放在了正确的目录下
- 给编年史的已有任务添加了维基链接
我将 README.md 的标题从关于改成了星际移民之书了，因为我发现 gitbook 客户端是根据这个标题来给整个书起名字的。
另外，我发现 gitbook 的命令行和客户端生成书的时候，文件的路径略有不同，所以我也开始用 gitbook 客户端了。
- 把两张图片放在了正确的路径，并删去了根目录下一个多余的文件夹
- 另外，发现了一点问题。对于自带括号的链接，比如说 http://en.wikipedia.org/wiki/Curiosity_(rover)
git网页里可以正常读取，但是gitbook却不能，生成的网页里链接也有问题。所以尝试了其它标记链接的方法，但同样不起作用，暂时还没有找到好的解决办法。
@SpaceXploration 那个链接问题似乎是 gitbook 的bug，如果感兴趣可以给 gitbook 提个 issue
https://github.com/GitbookIO/gitbook/issues/new
我在计划把我之前写的那些整理一下，特别是要把原来那些引用了我自己博客链接到部分去掉，然后整理成比较完整的段落文章。
但是考虑到传播效果，不能直接把原来的很技术性的文章直接拿过来，所以初步的想法是，把文章分成至少两部分，前半部分是用比较通俗的语言解释，后面的是作为附文，用比较严格的方法解释。
两部分如果有扩展阅读我也会分别加到相应的部分去。
- 添加更多的曲率引擎相关内容，去除我的博客链接。
链接里带括号的问题貌似在技术上暂时不能解决。
GitbookIO/gitbook#228
markedjs/marked#366
不过意外发现维基词条链接里带括号的，比如http://en.wikipedia.org/wiki/Sojourner_(rover)
删去链接内的括号依然可以指向正确的网页 http://en.wikipedia.org/wiki/Sojourner_rover
不过图片文件的链接却不行 http://zh.wikipedia.org/wiki/File:Mars_topography_(MOLA_dataset)_HiRes.jpg
因此只好把存在问题的图片链接转成短链接 http://goo.gl/iyk68V 来暂时解决这个问题
- 添加 CC BY-SA 共享协议；
- 添加右上角的两个连接。
- 更改主题为 Sepia
- 使用 Sans 字体，这样跟中文混排稍微好看些，至少在 Mac 上的默认字体要好看了。
- 添加 glossary 页面，在顶部有个这样的从 A 到 Z 的符号，这就是 glossary 的按钮
想做但是做不了的
- 顶部的那些分享按钮，想去掉但是去不掉……我以为设置文件 book.json 文件里面设置为 null 就可以了，但是不起作用，似乎是个 bug.
- Introduction 想要改成中文但是这个不受控制……………………对开发人员无语了，你们设计了多语言就不考虑这个……
- 我感觉night主题更好看一点，更有太空的感觉。。。
- 才发现右上角可以分享到微博！好评
- 新增的字体是Serif 还是Sans，我觉得Serif更好看啊。。
我原来打开book时，英文一直都是Sans的字体啊，我更喜欢Serif一点。另外，英文、中文的字体是可以自定义的么
@SpaceXploration 我知道了，因为这个设置是有记忆的，估计我以前什么时候设置成 Serif 忘记了，然后以为默认是 Serif ……
@SpaceXploration 好像不可以自定义字体，只能从这两类选择~