記事更新日: 2018年06月10日

手順書ワラベンチャー
- Procedure manual warabenture.

KITASHIRAKAWA_Chiyuri
「手順書ワラベンチャー」のページが開く……☆
"Procedure manual warabenture" page opens.

対象読者 - Target audience.

プラットフォーム - Platform Windows
用途 - Use マニュアルを書きたい - I want to write a manual.
使用ソフトとインストール方法 - Used software and instration Notepad++ v7.5.6
MarkdownViewer++ 0.8.2 (x64)
Snipping Tool v10.0.17134

目次 - Table of contents.

戻る - back

1. 印刷を考慮するの?
- Consider printing?

OKAZAKI_Yumemi
Git Hub に マークダウン・ファイル(<ファイル名>.md)で書けばよくない?
KITASHIRAKAWA_Chiyuri
手順書を必要とするのは 電話かけてくるような人なんで……☆
わたしたちは インクが中国で発明された紀元前3000年ぐらいに
生きているぐらいの感じで頼むぜ☆
KITASHIRAKAWA_Chiyuri
とりあえず 紙に印刷するなら A4サイズ、
ディスプレイで見るなら 横80文字、
電話口で 手順書を読まされるなら 聞き返されない程度にワンフレーズで切った文書にしておく、
ということが 生命線 だぜ☆
KIFUWARABE
バッド・ノウハウのかたまりか☆
戻る - back

2. どのソフトを使うの?
- Which software do you use?

OKAZAKI_Yumemi
だから Git Hub に マークダウン・ファイル(<ファイル名>.md)で書きましょうよ?
KITASHIRAKAWA_Chiyuri
開発者が設計図を公開しているサイトなんか見にいきたくないだろ……☆
マウスをクリックするのが精いっぱいだぜ☆
KIFUWARABE
Microsoft Word が鉄板か☆?
KITASHIRAKAWA_Chiyuri
体裁は整うが、あんな行間の広いリッチ・テキスト・ファイルなんか
使いたいとは思わない☆
プログラムのコードを書くような エディターでもないだろ☆
KITASHIRAKAWA_Chiyuri
そこで わたしがオススメするのは メモ帳だぜ☆
プレーン・テキスト☆
OKAZAKI_Yumemi
だから Git Hub に マークダウン・ファイル(<ファイル名>.md)で書きましょうよ!
戻る - back

3. わたしは Notepad++ を使う
- I use Notepad++.

KITASHIRAKAWA_Chiyuri
日本では流行ってないが、Notepad++ を使おうぜ☆?
KITASHIRAKAWA_Chiyuri
秀丸や さくらエディタ を使わないの?
KITASHIRAKAWA_Chiyuri
秀丸や さくらエディタで テキストの中に画像を埋め込む方法を知らない☆
手順書に画像は必須だろ☆
わたしの知ってる方法が Notepad++ なんで、 Notepad++ を使うだけだぜ☆
KIFUWARABE
黙って Visual Studio Code にしとけばいいのに……☆
20180610procman1.png
KITASHIRAKAWA_Chiyuri
gif はアニメしないが、
テキストに画像を付けれるのがメリットだぜ☆
これを git に放り込めば版管理もできるだろ☆
KIFUWARABE
このホームページも マークダウンにしてくれだぜ☆
KITASHIRAKAWA_Chiyuri
カスタマイズに時間を食ってしまうので嫌だぜ☆
20180610procman2.png
KITASHIRAKAWA_Chiyuri
こんな感じに HTMLファイル に書き出してくれるのだから、
その書き出し部分を編集できれば 話しは早いんだが 公開されてないんで、
スタイルを設定する部分は 期待できないぜ☆
MarkdownViewer++の作者が HTML5/CSS に詳しくないのかもしれないしな☆
KIFUWARABE
ソースコードなら GPLライセンス で Git Hub に公開されてるだろ☆
KITASHIRAKAWA_Chiyuri
そこからか☆
ソースコードのディレクトリ構成が わたしの好みじゃないんだぜ☆