melborne / togglate Goto Github PK

Sequential liquid tag blocks, like following, have not wrapped correctly.

{% highlight ruby %}
{% raw %}{% include sig.md %}{% endraw %}
{% endhighlight %}

It should not be parsed as a code block but parsed as a part of a list item.

- list1
- list2
    memo
- list3

• reconstruct each api call so that each bulk size is closed to the limit(500 characters)

• extract only comment tag blocks from source file.
• enable specifying the target other than comment tag.

ローカルにcloneした文書(Togglateで原文コメントアウト済、翻訳文章追加済)と、特定リビジョンの原文を比較し、
原文に差異がないか確認するコマンドが欲しいので作成してみました。

gosyujin@8d66b93

大まかな動作としては、

1. git remote add togglate で原文取得用のリモートリポジトリをGitに登録する
2. togglate diff コマンドに 比較したいファイル 特定のリビジョン を渡す
   1. ローカルの 比較したいファイル を togglate commentout で原文だけにする
   2. リモートリポジトリ togglate から 特定のリビジョン の 比較したいファイル を取得してくる
   3. i. ii. のファイルのdiffを取る

こんな感じになります。(Jekyllの原文ドキュメントに対してdiffをとる)
翻訳したリビジョンを対象とする場合。

$ git remote -v
(略)
togglate    https://github.com/jekyll/jekyll.git (push)

$ bundle exec togglate diff docs/configuration.md --revision 5daf987 --difference site
Local doc: docs/configuration.md
Original doc url: https://raw.githubusercontent.com/jekyll/jekyll/5daf987/site/docs/configuration.md
 GitHub user: jekyll
 GitHub repository: jekyll
 Revision: 5daf987
Diff result: OK

時間がたち、原文のリポジトリの master がかなり進んでNGとなる場合。

$ bundle exec togglate diff docs/configuration.md --revision master --difference site
Local doc: docs/configuration.md
Original doc url: https://raw.githubusercontent.com/jekyll/jekyll/master/site/docs/configuration.md
 GitHub user: jekyll
 GitHub repository: jekyll
 Revision: master
--- docs/configuration.md_togglate_local    2014-04-28 01:29:52.138137854 +0900
+++ docs/configuration.md_togglate_original 2014-04-28 01:29:52.240138863 +0900
(略)
 markdown:      kramdown
-markdown_ext:  markdown,mkd,mkdn,md
+markdown_ext:  markdown,mkdown,mkdn,mkd,md
 textile_ext:   textile

 excerpt_separator: "\n\n"
Diff result: NG

良い案が思いつかなかったため diff という一般的すぎるコマンドで拡張してしまいましたが、
commentout コマンドの拡張とすべきとか
別のレイヤーでやるべき(元々は Rake で作っていました)とか
意見いただけたらと思います。
(ソース自体はもうちょっと整理しようと思っています)

a html tag block has wrapped separately. It should wraps by one wrapper.

togglate does not handle this type of code blocks correctly.

togglate create のオプションとして、

1． 原文をHTMLのコメントタグ <!--original --!> で囲む
2． トグル用のJavascriptを埋め込まない

モードがあるといいな、と思いました(コメントモードの意で -c 、もしくはプレーンモードの意で -p とか)。

背景

自分が取り組んでいる Pro Git の翻訳では、

1． 原文をコードブロックで囲む
2． 本文にない Javascript コードを訳文に埋め込む

のいずれも受け入れられないはずです。本家サイト公開用に変換するHTMLに、望まない影響が出るためです。Sinatra のドキュメントも同様かと思いますがいかがでしょうか…