melborne / togglate Goto Github PK
View Code? Open in Web Editor NEWA tool for creating a base text of translation
License: MIT License
A tool for creating a base text of translation
License: MIT License
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
ローカルにcloneした文書(Togglateで原文コメントアウト済、翻訳文章追加済)と、特定リビジョンの原文を比較し、
原文に差異がないか確認するコマンドが欲しいので作成してみました。
大まかな動作としては、
git remote add togglate
で原文取得用のリモートリポジトリをGitに登録するtogglate diff
コマンドに 比較したいファイル
特定のリビジョン
を渡す
比較したいファイル
を togglate commentout
で原文だけにするtogglate
から 特定のリビジョン
の 比較したいファイル
を取得してくるこんな感じになります。(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 のドキュメントも同様かと思いますがいかがでしょうか…
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.