NIST SP 800-63-3 Final 翻訳の進め方

sp800-63-3-trans.md

GitHub Repository

https://github.com/openid-foundation-japan/800-63-3-final

HTML 確認方法

上記レポジトリが Private Repository なので GitHub Page はなし。

Jekyll という Ruby 製の CMS (?) を使うと、localhost 上で Markdown を HTML 化して確認可能。

Ruby をインストールした状況で、以下のコマンド実行すると、http://0.0.0.0:4000/800-63-3-final/ にサーバーが立ち上がる。

% gem install jekyll # 初回のみ
% cd /path/to/800-63-3-final
% jekyll server

翻訳ルール

• まずはレポイトリを fork
• 適宜 pull request を送る
• *.md -> *.ja.md に rename
• *.ja.md を翻訳
• root 直下の sp800-63*.ja.md から include されている file path も適宜 *.md -> *.ja.md に rename
• 句読点は "." & "," ("。" & "、" はなし)
• definitions に定義されたている用語は翻訳しない (e.g. "Authenticator" は "認証器" ではなく "Authenticator" のまま)

翻訳締め切り

ドキュメント	締め切り	担当者
800-63-3	9/28	Nov
800-63A	9/28	さみーちゃん
800-63B	10/12	かっつん & きむらさん
800-63C	10/12	Nov

環境によっては以下のようになってしまう．

$ jekyll server
/Library/Ruby/Gems/2.3.0/gems/bundler-1.16.0/lib/bundler/runtime.rb:313:in `check_for_activated_spec!': You have already activated public_suffix 3.0.1, but your Gemfile requires public_suffix 2.0.5. Prepending `bundle exec` to your command may solve this. (Gem::LoadError)
	from /Library/Ruby/Gems/2.3.0/gems/bundler-1.16.0/lib/bundler/runtime.rb:31:in `block in setup'
	from /Library/Ruby/Gems/2.3.0/gems/bundler-1.16.0/lib/bundler/runtime.rb:26:in `map'
	from /Library/Ruby/Gems/2.3.0/gems/bundler-1.16.0/lib/bundler/runtime.rb:26:in `setup'
	from /Library/Ruby/Gems/2.3.0/gems/bundler-1.16.0/lib/bundler.rb:107:in `setup'
	from /Library/Ruby/Gems/2.3.0/gems/jekyll-3.6.2/lib/jekyll/plugin_manager.rb:50:in `require_from_bundler'
	from /Library/Ruby/Gems/2.3.0/gems/jekyll-3.6.2/exe/jekyll:11:in `<top (required)>'
	from /usr/local/bin/jekyll:22:in `load'
	from /usr/local/bin/jekyll:22:in `<main>'

だったり，以下だとレイアウトが読めず，期待したページ生成ができない（内容は読めるけど）．

$ jekyll server
Configuration file: none
            Source: /Users/kthrtty/git
       Destination: /Users/kthrtty/git/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
     Build Warning: Layout 'page' requested in 800-63-3-final/comment_help.md does not exist.
     Build Warning: Layout 'cover' requested in 800-63-3-final/index.ja.md does not exist.
     Build Warning: Layout 'cover' requested in 800-63-3-final/index.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63-3.ja.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63-3.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63a.ja.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63a.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63b.ja.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63b.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63c.ja.md does not exist.
     Build Warning: Layout 'page' requested in 800-63-3-final/sp800-63c.md does not exist.
                    done in 11.474 seconds.
 Auto-regeneration: enabled for '/Users/kthrtty/git'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.

そういうときは，以下のようにすると正しくページの生成が行える場合がある．

$ bundle exe jekyll server
Configuration file: /Users/kthrtty/git/800-63-3-final/_config.yml
            Source: /Users/kthrtty/git/800-63-3-final
       Destination: /Users/kthrtty/git/800-63-3-final/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 4.292 seconds.
 Auto-regeneration: enabled for '/Users/kthrtty/git/800-63-3-final'
    Server address: http://0.0.0.0:4000/800-63-3-final/
  Server running... press ctrl-c to stop.