「reStructuredText」を含む日記 RSS

はてなキーワード: reStructuredTextとは

2021-10-29

程良い難易度で新しいことを覚えて行くのは楽しい

1. Markdown, Textileは知っていた。

2. 「何か新しいことを覚えようかなぁ」というコレクター魂のようなもので、reStructuredTextの手を付ける。

3. Sphinxなるものを知る。PythonからDjangoとか、あの見慣れたチュートリアルを作るドキュメントツールSphinx

4. 面白いのだけど登場人物が多くて話が追えないなろう系のメモとして使ってみる。

5. 慣れた頃に、高校物理数学の復習へ逸れる。

6. LaTeX記法での数式表現、Matplotlibの機能に感動する。

7. 気づくと書き貯めたメモ(rstファイル)が大量に…

8. 索引ページに気づく。

9. 日本語表示がイケてない。微分なら「は」の項目に、積分なら「さ」の項目に表示してほしいじゃん?「微」「積」の項目なんよ。。英語と同じように「頭の一文字」を取ったらそうなるよね。

10. 探してみたら、「Yogosyu」というプラグイン(※Sphinxでは拡張モジュール)があった。使ってみる。

11. 最新のSphinx対応していない。ここからPythonコード解析へと逸れる。

12. 取り敢えずエラーはでなくなったけど、元々索引ページとは関係ない機能だった。同一「用語集」での表示順が日本語対応するだけ。

13. (しばらく放置

14. 「単語の先頭に振り仮名を付け足せば、いい感じにソートしてくれる?」と気付く。

15. 表示の直前で「振り仮名」を取除くために、どこで表示しているか探す。

16. (紆余曲折

17. 索引ページで思ったように表示されて喜ぶ。

18. ここで初めて「プラグイン形式にすれば良くね?」と気付く。

19. 他の拡張モジュールソースを見てやり方を学ぶ。

20. 出来上がって喜ぶ。

21. ここで初めて「これってクラスにしたら、全体の見通しが良くなったりする?」と気付く。

22.(この辺りで、unittestモジュールに手を付ける)

23. テストケースのお陰でリファクタリングが怖くない。喜ぶ。

24. setup.py, setup.cfgの書き方を学ぶ。

25. pypi公開を果たす。誰にも知られずひっそりと…

26. テストケースにjinja2を通した結果も加える。一人で成果に喜ぶ。

27. githubに手を付ける。学ぶ。基本的なことは覚える。

28. スタックオーバーフロー登録モブ参上

29. stack overflow登録モブ参上

30. teratailに登録。コソコソ。「何がなんだか分からない」では質問しないし、そのうちどうにかなることが多い。先駆者感謝

31. toxを知る。学ぶ。基本的なことは覚える。

32. coverageを知る。学ぶ。基本的なことは覚える。

33. circleciを知る。学ぶ。基本的なことは覚える。

34. カバレッジが90%を超えて喜ぶ。←今はこの辺。

※ボッチの日常

2016-05-07

http://anond.hatelabo.jp/20160507163959

流し読んで、そうかぁー、ぐらいに思ったけれど。

Wiki日本語英語wikipedia説明を読むと、まんま書いてあって。

  

それまでのマークアップ言語の一つとして、e-mail表記方法などから着想を得ている、ということらしいよ。

https://en.wikipedia.org/wiki/Markdown

  

wikiの出典として下記の記事が使われていて、

http://daringfireball.net/projects/markdown/syntax#philosophy

そこでは、

While Markdown’s syntax has been influenced by several existing text-to-HTML filters — including Setext, atx, Textile, reStructuredText, Grutatext, and EtText — the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.

Setext, atx, Textile, reStructuredText, Grutatext, and EtText とか、初めて聞いたけれど、そんな幾つかのマークアップ言語

最大の影響を与え、着想の元となったものは、平易なプレーンテキストe-mailの書き方です。

みたいに書いてるね−。

物知り元増田に素直な増田質問してくれて、分かりやすくなったヨ。

(つうか、元増田よりも、はてな記法に習熟してそうな増田だな)

 
ログイン ユーザー登録
ようこそ ゲスト さん