Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

做了一个实现 #6

Open
Gwill opened this issue Apr 22, 2012 · 5 comments
Open

做了一个实现 #6

Gwill opened this issue Apr 22, 2012 · 5 comments

Comments

@Gwill
Copy link
Member

Gwill commented Apr 22, 2012

这个周末把网站的框架弄起来了。
因为彻底偏离了谢大所计划的路线图,所以就不去动主代码库了。

主要实现了:

  1. 全静态
  2. 使用bootstrap
  3. 代码高亮
  4. 源代码文件可抽离
  5. 搜索
  6. 章节 github issue 回馈
  7. disqus接入

现在的内容只是为了制作测试而用,只是粘贴了一部分。

来日慢慢充实。

具体的实现可以看这里:

http://cnrug.org/r-tutorial/

@wangyuchen
Copy link
Member

Hi,请问什么是源代码文件可抽离呢?
我们是共同在这个基础上继续吗?那还是把代码共享吧

@Gwill
Copy link
Member Author

Gwill commented May 4, 2012

Hi,请问什么是源代码文件可抽离呢?
我们是共同在这个基础上继续吗?那还是把代码共享吧

这个是我自己的实验,和谢大计划的很不一样。

代码一直都是公开的。在这里: https://github.com/cnrug/r-tutorial

如果你装了Sphinx,clone下来代码,在目录直接 make html 就得到全站的静态文件了。

之所以挂了另外一个域名是因为里面用了disqus,他需要一个固定的域名做唯一标识来显示评论。

关于分离源代码是这样,我用Sphinx做的,主要是完成了一个Sphinx的theme。所以在撰写的时候可以直接

.. literalinclude:: _src/code.R

来引用一个已经存在的源代码文件(还可以配置是否显示行号之类的参数)。

因为Sphinx本身的theme机制,所以源文件与展示是脱离的。

具体怎么写可以参考rst和Sphinx使用相关文档。

@yihui
Copy link
Member

yihui commented May 8, 2012

disqus的唯一标识不一定非得是域名吧?只要在同一个注册ID下的不同页面的唯一标识不同应该就可以了。

literalinclude只能插入代码,不能运行代码并输出结果吧?

@Gwill
Copy link
Member Author

Gwill commented May 8, 2012

disqus的唯一标识不一定非得是域名吧?只要在同一个注册ID下的不同页面的唯一标识不同应该就可以了。

配置里有一处要配置全url,所以我觉得需要一个域名。不过我没有仔细阅读文档。

literalinclude 只能插入代码,不能运行代码并输出结果吧?

这个确实不能。

@yihui
Copy link
Member

yihui commented May 8, 2012

我基本确定域名不是必须的,所有配置中,只有disqus_shortname是必须的;还有一个可选的disqus_identifier用来区分同一个shortname下的不同页面,例如它可以是页面URL。

运行代码可以用knitr上场,这个不难。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants