venliong / crxdoczh Goto Github PK

例如 
https://crxdoc-zh.appspot.com/trunk/extensions/devtools.inspectedWindow.html
但是https://developer.chrome.com/trunk/extensions/devtools.inspectedWindow.htm
l 
以及https://developer.chrome.com/trunk/extensions/devtools_inspectedWindow.htm
l 都能正常访问。

Chromium Git migration will finally happen. The flag day has been planned on 
August 22, 2014. See 
https://groups.google.com/a/chromium.org/forum/#!topic/chromium-dev/Gw4NYxyr3n8.

We are going to do translation in the new Git repo, but mirror everything back 
into this SVN repo to make server-side code simple.

Translation is currently in progress.

官方文档的服务器通过获取 ViewVC 
上的版本信息判断文件是否更新，目前 slave-docs 
直接将版本置为 
0，理论上说被缓存后有可能永远得不到更新。
此外渲染后的网页还会在内存和数据库中缓存，到了 master 
服务器上还有一级内存缓存。

文档更新可通过周期性地获取并分析 
https://code.google.com/feeds/p/crxdoczh/svnchanges/basic 
（似乎包含完整的更新日志），然后相应地清除内存缓存。
渲染后的网页可以像 slave-samples 一样定期更新。
如果可能的话，还可以提供一个接口，手动清除某些缓存的��
�面（需要管理权限，但不用在 appengine.google.com 上进行）。

此外，当某个分支的 Chrome 
版本升级时（这里指主版本号，或 
Mstone），该分支的所有文档都必须全部更新（还有可能有新��
�或删除的页面）。

例如：https://crxdoc-zh.appspot.com/trunk/extensions/alarms.html
（服务器代码还未提交到源代码库中）
怀疑是 slave-docs 服务器之前测试 slave-samples 时留下的 Memcache 
导致的。

After DevTools documentation is translated and deployed.

It's VERY UGLY, MESSY and hard to maintain (it's not synced with the current 
version of server2). And I'm more familiar with server2 and Python than before.

Proposals:
Write CrxdoczhSamplesDataSource, GoogleCodeSubversionFileSystem and import the 
correct classes in server_instance.py.
Write an APIServlet to serve API requests.
Reuse existing AppEngineUrlFetcher, PersistentObjectStore, etc.
Keep changes that's possible to cause merge conflicts as minimal as possible.

URL：https://crxdoc-zh.appspot.com/apps/angular_framework
位置：‘源代码在 GitHub 上可用’的链接
改正后应该是：https://github.com/GoogleChrome/chrome-app-samples/tree/mas
ter/gdrive
原来是：https://github.com/GoogleChrome/chrome-app-samples/tree/master/gdocs

渲染任何一个存在的 HTML 文件，都会输出：

ERROR:root:Handlebar error(s) rendering extensions/messaging.html:
Couldn't resolve identifier [u'item', u'title']

但是并不影响最终生成的文档。

grep 'item\.title'，似乎只有 docs/templates/private/sidenav_item.html 
中使用。

如果是与翻译有关的问题，请在上面选择“翻译问题”模
板。
如果是错别字等一般错误，请选择“纠错”模板。

网址：
https://crxdoc-zh.appspot.com/<...>

该页面的哪一部分有问题？

请详细描述问题或说说您的意见或建议：

他人可以参与翻译的贡献么？

Chromium's docserver does not render all files in cron_servlet.py any more. 
They're rendered in ContentProvider's cron jobs. We should modify it to push 
updates to the master server.

Needed to be correct decoding path. 

URL：https://crxdoc-zh.appspot.com/extensions/runtime#method-sendMessage
位置：该页面的中tabs.connect和tabs.sendMessage的跳转链拼写错误�
��
应该把"/extensins/tabs#method-sendMessage"改成"/extensions/tabs#method-send
Message","/extensins/tabs#method-connect"改成""/extensions/tabs#method-connect
""
PS: 
不知道其他页面有这个拼写错误不，最好全局搜索下extensins��
�

docs/templates/intros/*.html 
中不少文件的开头都具有固定的格式，为了维护方便，可以��
�虑通过 JSON 与固定的模板自动生成。

https://src.chromium.org/viewvc/chrome?view=rev&revision=184126
https://chromiumcodereview.appspot.com/12221067

欢迎贡献翻译！

显然 Python（2）是首选语言。

希望有如下功能：
1、检测无效的内部链接，包括 #xxx 部分。
2、检测外部链接，列出非 https 
链接、包含重定向的链接、code.google.com 上的旧链接等。

不需要检测 $ref:xxx，Chromium 已有自动检测工具。

我使用 http://crxdoczh.googlecode.com/svn/trunk/crxdoczh-read-only 
这个地址，无法获取文档源文件。SVN报错：URL 
'http://crxdoczh.googlecode.com/svn/trunk/crxdoczh-read-only' doesn't exist

因为您的项目，在国内无法访问（原因我们都懂的），所以��
�自己FQ，将您的这一份文档布置在了我自己的网站上：docs.lmk
123.com。但每次更新都会很麻烦，所以想直接获取源文件。另�
��，我准备着手将文档重新设计，让手机用户也能方便的阅读
。

URL：https://crxdoc-zh.appspot.com/extensions/runtime.html#event-onMessage
位置：网页源代码1689行
改正后应该是：onMessage 
原来是：onRequest

注意：该模版仅用于报告错别字、无效链接等一般问题，
如果是翻译问题或其他反馈，请选择合适的模板。
如果您知道如何在源代码中改正错误，请浏览至源代码（
http://goo.gl/QMsP5）中的相应文件，单击右上角的“Edit
File”链接，编辑后提交。