ayatakesi / emacs-26.3-doc-emacs

Other
2 stars 1 forks source link

報告方法? #1

Open tsuu32 opened 4 years ago

tsuu32 commented 4 years ago

こんにちは。最近この日本語版Emacs manualを読ませていただいています。素晴らしいプロジェクトをありがとうございます。

読んでいて、いくつか貢献したいと思うところがありました。 どのように報告するのがいいでしょうか?

  1. Issueで報告
  2. PR

また、PRするためにtexinfo、po4aなどの環境を整えました。 ただ、どのファイルを変更してPRを送ればいいのかよくわかっていません。 このリポジトリではpoファイルと翻訳済みtexiが管理されています。生成されるtexiファイルがgitで管理されているのは不自然だと思ったのですが、これは意図的なのでしょうか?また、ayatakesi/emacs-26.2-doc-emacsではpotファイルとpoファイルが管理されていて、やはりどのファイルを変更してPRすればいいかわかりません。

.gitignoreがあると便利な気がします。

ayatakesi commented 4 years ago

貢献のご提案、ありがとうございます。報告についてはメール、gitメソッド、何でも結構です、大歓迎です。 「gitリポジトリとしてどーなのか?」という点ですが、 ·とりあえず訳したものを手っ取り早く公開したい ·やってしまったとき用に版管理もあればいいな

くらいの気持ちで作ったもので、実際にリポジトリとして必要な肝は ·.po(翻訳) ·original_files/.texi(翻訳を反映するための原文) ·Makefile(作業の自動化) ·*.sh(gettextで反映を行うのが難しい文字列の翻訳)

だと思います。 でリポジトリをどーにかしたいとは自分も思っているものの、翻訳作業に追われてリポジトリの整理には手がつけられないのが現状です(EmacsとEmacs Lispの最新安定版のマニュアルに追いつけたらgitちゃんと勉強しようかな、というレベルで…。現状では版毎にリポ切っているというお恥ずかしい状況であります)

ただ以前にslackのemacs-jpでいずれ私個人のリポ&著作からemacs-jp関連のリポ&著作に移して貰えないか、という話しはしてありまして、それまでには何とかしたいと思ってます

tsuu32 commented 4 years ago

貢献のご提案、ありがとうございます。報告についてはメール、gitメソッド、何でも結構です、大歓迎です。

ありがとうございます。プルリクエストを送りたいと思います。

でリポジトリをどーにかしたいとは自分も思っているものの、翻訳作業に追われてリポジトリの整理には手がつけられないのが現状です(EmacsとEmacs Lispの最新安定版のマニュアルに追いつけたらgitちゃんと勉強しようかな、というレベルで…。現状では版毎にリポ切っているというお恥ずかしい状況であります)

わかりました。ちょっと私の方で整理してみたいと思います。 具体的にはオリジナルtexiとpoから生成されるtexiファイルなどの生成物はgitで管理しないよう.gitignoreを追加したいと思います。ただ、#2 に気づけたのは 最終生成物である emacs-ja.html がgitで管理されていたためでした。emacs-ja.htmlだけは.gitignoreにいれずgitにアップロードするようにしたいと思います。

tsuu32 commented 4 years ago

po4aのドキュメント(https://manpages.debian.org/testing/po4a/po4a.7.ja.html)を読んで、po4a-updatepoというスクリプトを知りました。 下のように使い、最新版のオリジナルのドキュメントと古い版用のpoファイルをとって、poファイルをアップデートします。

po4a-updatepo -f <format> -m <new_master.doc> -p <old_doc.XX.po>

どうやら内部では「po4a-gettextizeして(新しいpotファイルと既存のpoファイルで)msgmergeする」相当のことが行われるようです。 ということで、このリポジトリのinitialize-po.shpo4a-updatepoを使えば短く書けそうです。

ただ、initialize-po.shにはパスがハードコードされてるため触らないことにします。 一応メモということで書いておきます。

ayatakesi commented 4 years ago

まず最初に、ごめんなさい!です *.shが必要と言いましたが、initialize-po.shは新版リポ作成時に旧版翻訳をマージする純粋な作業用のシェルでした。という訳で不要ですm( ;)m でpo4a-updatepoですが、知りませんでした。次の新版対応の翻訳元作成時に試してみたいと思います、ありがとうございました