Autosar文書、参考文献、略号一覧（作成中23/237）：英語(40)
https://qiita.com/kaizen_nagoya/items/2325b0156bc7fcf5a96d
の作成手順を記録します。
<この項は書きかけです。順次追記します。>
docker起動して作業
この作業自体が、下記作業の補助作業。
Autosar Document
https://www.autosar.org/nc/document-search/
Autosar単語帳(作業中)
https://qiita.com/kaizen_nagoya/items/0927727a94b157df2df8
docker run -v /Users/administrator/Downloads/autosar:/tmp/docker -it kaizenjapan/autosar /bin/bash
/Users/administrator/Downloads/autosarは実在するフォルダ名。
または
docker run -v /tmp/docker:/tmp/docker -it kaizenjapan/autosar /bin/bash
/tmp/dockerは実在するフォルダ名
#pdfファイルのありか
docker 上の /home/autosar/autosar_latest
のpdfフォルダを
/tmp/dockerに複写してある。
あるいは、dockerを起動したシステムのフォルダにあることを想定する。
なければ、
# mkdir /tmp/docker/pdf
# cp /home/autosar/autosar_latest/pdf/* /tmp/docker/pdf
macOSならプレビューで開く
なぜか、acrobat readeで読むと文字列のコピペができない。
ファイル名を右クリックして「このアプリケーションで開く」で、「プレビュー」を選んで開く。
見出しをコピーペする
みだしもじの#を行頭につける。githubでは#の後に半角空白がいる。先にgithubに作るか、後でコピペするか、どちらでも同じように作業する。
reference をコピペする
table of contentsの前にあるか、後ろにあるかどちらかの場合がある。みあたらなければ、文書の末尾をみるか、referenceで検索する。
Specification of Module XCP
のように、 Related documentationとしてreferenceでない場合もある。整合性がない文書ほど役に立つという経験則からすれば大事。
table of contentsの中にreferenceがどこにあるか示していない場合があり、何を考えているのかよくわかっていない。
reference の前に##をつける。githubでは#の後に半角空白がいる。先にgithubに作るか、後でコピペするか、どちらでも同じように作業する。
頁をまたぐ場合は、文書名、頁番号などの文字列を削除する。
abbreviationをコピペする
referenceの前後か、先頭か最後をみる。abbreviation, acronymで検索する。
glossaryをreferenceで参照していればないのは納得できる。
glossaryをreferenceで参照していなくてないのは、参照している文献がglossaryを参照しているか、abbreviationがあればいいという意味だと理解。
Specification of ECU Resource Templateのp.7には、
Where applicable, please consult the glossary and the abbreviation list contained in this document.
という記述がある。
ISOなどの標準では、this document といったら、今現在、文章を記述している文書を指す。もし、glossaryを指すのであれば、the documentの方がいいかも。"Where applicable, please consult the glossary and the abbreviation list contained in the document. "とするとよいかも。Autosar会員の誰かが意見(comment)提出してくださることを期待します。
abbreviationに対してmeaningはどうなんだろう。
Specification Wireless Ethernet Transceiver Driverでは、Abbreviation / Acronymに対してDescription
で、descriptionの方が落ち着く。
abbreviation の前に##をつける。githubでは#の後に半角空白がいる。先にgithubに作るか、後でコピペするか、どちらでも同じように作業する。
頁をまたぐ場合は、文書名、頁番号などの文字列を削除する。
表形式に整形する。
Qiitaにコピペすれば、markdownで表になる場合と、ならない場合がある。
Excelからコピペしても同様。
原理がまだよくわかっていない。
githubに表を作成する場合、いつも、Qiitaにコピペしてから、githubにコピペしている。
＜この記事は個人の過去の経験に基づく個人の感想です。現在所属する組織、業務とは関係がありません。＞
文書履歴(document history)
ver. 0.01 初稿 20200123 午前
ver. 0.02 表形式追記 20200123 昼
最後までおよみいただきありがとうございました。
いいね 💚、フォローをお願いします。
Thank you very much for reading to the last sentence.
Please press the like icon 💚 and follow me for your happy life.