Skip to content
Shimada Takayuki edited this page Aug 24, 2023 · 15 revisions

リポジトリをチェックアウトする

WAICのaria-practicesリポジトリをチェックアウトする

git clone [email protected]:waic/aria-practices.git

本家のリポジトリをリモートw3cとして登録する。

git remote add w3c [email protected]:w3c/aria-practices.git

以上で、originがWAICのリポジトリ、w3cが本家のリポジトリとしてチェックアウトされます。

WAICリポジトリを本家に追随する

WAICリポジトリを最新の本家のコミットまで追随するには次の手順をなぞってください。

※この手順によって本家で行われた変更が日本語版に適用されることはありません。

作業はmainブランチで実行します。

git checkout main

mainブランチをw3cから最新化

git pull w3c main

origin = WAICのリポジトリにpush

git push origin main

現在公開中のAPGのバージョンを特定する

w3c/wai-aria-practicesリポジトリのpublicationブランチから参照されているaria-practicesリポジトリのバージョンを確認する。

_external ディレクトリを開いたときの画面キャプチャ

aria-practices @ に続く7桁の16進数の表記がコミットハッシュの冒頭7桁。フル長のハッシュを確認するにはリンク先をたどる。URL末尾の40文字の16進数表記がそれ。

ページ洗い出し

page url
Home https://www.w3.org/WAI/ARIA/apg/
Read Me First https://www.w3.org/WAI/ARIA/apg/practices/read-me-first/
Patterns https://www.w3.org/WAI/ARIA/apg/patterns/
Accordion (Sections With Show/Hide Functionality) https://www.w3.org/WAI/ARIA/apg/patterns/accordion/
Alert https://www.w3.org/WAI/ARIA/apg/patterns/alert/
Alert and Message Dialogs https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/
Breadcrumb https://www.w3.org/WAI/ARIA/apg/patterns/breadcrumb/
Button https://www.w3.org/WAI/ARIA/apg/patterns/button/
Carousel (Slide Show or Image Rotator) https://www.w3.org/WAI/ARIA/apg/patterns/carousel/
Checkbox https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/
Combobox https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
Dialog (Modal) https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/
Disclosure (Show/Hide) https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
Feed https://www.w3.org/WAI/ARIA/apg/patterns/feed/
Grid (Interactive Tabular Data and Layout Containers) https://www.w3.org/WAI/ARIA/apg/patterns/grid/
Landmarks https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/general-principles.html
Link https://www.w3.org/WAI/ARIA/apg/patterns/link/
Listbox https://www.w3.org/WAI/ARIA/apg/patterns/listbox/
Menu and Menubar https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
Menu Button https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/
Meter https://www.w3.org/WAI/ARIA/apg/patterns/meter/
Radio Group https://www.w3.org/WAI/ARIA/apg/patterns/radio/
Slider https://www.w3.org/WAI/ARIA/apg/patterns/slider/
Slider (Multi-Thumb) https://www.w3.org/WAI/ARIA/apg/patterns/slider-multithumb/
Spinbutton https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/
Switch https://www.w3.org/WAI/ARIA/apg/patterns/switch/
Table https://www.w3.org/WAI/ARIA/apg/patterns/table/
Tabs https://www.w3.org/WAI/ARIA/apg/patterns/tabs/
Toolbar https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/
Tooltip https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/
Tree View https://www.w3.org/WAI/ARIA/apg/patterns/treeview/
Treegrid https://www.w3.org/WAI/ARIA/apg/patterns/treegrid/
Window Splitter https://www.w3.org/WAI/ARIA/apg/patterns/windowsplitter/
Practices https://www.w3.org/WAI/ARIA/apg/practices/
Landmark Regions https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/
Providing Accessible Names and Descriptions https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/
Developing a Keyboard Interface https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/
Grid and Table Properties https://www.w3.org/WAI/ARIA/apg/practices/grid-and-table-properties/
Communicating Value and Limits for Range Widgets https://www.w3.org/WAI/ARIA/apg/practices/range-related-properties/
Structural Roles https://www.w3.org/WAI/ARIA/apg/practices/structural-roles/
Hiding Semantics with the presentation Role https://www.w3.org/WAI/ARIA/apg/practices/hiding-semantics/
Index https://www.w3.org/WAI/ARIA/apg/example-index/
About https://www.w3.org/WAI/ARIA/apg/about/
Introduction https://www.w3.org/WAI/ARIA/apg/about/introduction/
ARIA Basics https://www.w3.org/WAI/ARIA/apg/about/aria-basics/
Acknowledgements https://www.w3.org/WAI/ARIA/apg/about/acknowledgements/
Change History https://www.w3.org/WAI/ARIA/apg/about/change-history/
Related Specifications https://www.w3.org/WAI/ARIA/apg/about/related-specifications/
Coverage and Quality Report https://www.w3.org/WAI/ARIA/apg/about/coverage-and-quality/

特定のページを翻訳する手順

例として、Button Patternページを翻訳する手順を記載する。

前提条件:この文書冒頭の「リポジトリをチェックアウトする」は済ませてあること。

1. リポジトリを最新状態にする

git fetch --all

2. 作業用ブランチを作成する

git checkout -b button-ja origin/waic-main

3. 以下のURLから翻訳元のリビジョンを特定する

https://github.com/w3c/wai-aria-practices/tree/publication/_external

aria-practices @ {ハッシュ値}

リンクをたどり、URL末尾のコミットハッシュを控えておく。

4. 翻訳するファイルを特定する

Button Patternの場合:content/patterns/button/button-pattern.html

5. 翻訳するファイルを翻訳元のリビジョンに合わせる

git checkout {ハッシュ値} content/patterns/button/button-pattern.html

{ハッシュ値}には3番目の手順で取得したコミットハッシュを指定する。

6. 翻訳する。

<h1>の直下くらいに翻訳元リビジョンを記載しておく。

<h1>Button Pattern</h1>
<!-- 翻訳元リビジョン: https://github.com/w3c/aria-practices/tree/d6cf9d8db772603a456e7d7ef52e409d39124301 -->

参考

7. 変更をコミットする

git commit -m "○○○を日本語化する"

8. リモートリポジトリへpushする

git push

9. プルリクエストを作成し、誰かにレビュー依頼する。

Clone this wiki locally