portray
Home Home Changelog Troubleshooting Contributing Quick Start Reference Home Read Latest Documentation - Browse GitHub Code Repository The only thing worse than documentation never written, is documentation written but never discovered. portray is a Python3 command line tool and library that helps you create great documentation websites for your Python projects with as little effort as possible. Ke
Python で Github Flavored Markdown をレンダリングする - tototoshi の日記
前回の補足的な内容 python の Markdown ライブラリ自体は Github Flavored Markdown(GFM) をサポートしていない。 >>> import markdown >>> markdown.markdown("```python\ndef hello():\n print('hello')\n```") u"<p><code>python\ndef hello():\n print('hello')</code></p>" python の Markdown ライブラリは拡張可能になっている。Markdown ライブラリの拡張ライブラリとして py-gfm を使うと gfm も扱えるようになる。 >>> import markdown >>> markdown.markdown("```python\ndef hello():\n print('hello
Parm - 大型プロジェクトにも対応できるMarkdownドキュメントコンバーター MOONGIFT
記法のシンプルさ、機能そして素の状態でも可読性が高いと言ったこともあって人気のMarkdown。利用範囲がどんどん広がっています。READMEだけでなく、プロジェクトのドキュメントを書く際にも利用してみると良いでしょう。 そうなると単純に一つのMarkdownファイルだけでなく、複数のファイルで構成した分かりやすいドキュメント構成にしたくなるはずです。そこで使ってみたいのがParmです。 ParmはPython製のスクリプトで、parと組み合わせ使います。どちらもインストールはpipでできます。 まずはparのインストールから。 $ pip install par Downloading/unpacking par Downloading par-0.9.5.tar.gz Running setup.py egg_info for package par Installing collec
mooをフォークしてmeowをリリースしました | hexacosa.net
以前紹介した markdownファイルをリアルタイムプレビューできるツール moo 。 現在はJavaScriptをベースにしたツールに変わってしまったため、 reStructuredTextファイルも変換できるようにしたPython版をフォークして meow としてリリースしました。 mooの作者とのやり取りは このあたり 。 Python3でも動作します。 コードはGitHubにあげています 。 インストールと使い方 インストール $ pip install meow 起動。 $ meow REST.rst Preview on http://127.0.0.1:7777 Hit Ctrl-C to quit. 2013-06-22 00:37:21 INFO detected file change Ctrl+Cで停止します。 一度使ってみてください。では。
uu59のメモ | cramでvagrantのVMをテストする
cramという便利なものがあります。これは語弊のある言い方をするとRubyでいうcucumber/turnipのようなテストツールです。サンプルを見たほうが早いと思いますが、普通にMarkdownとかを書く感じでテストを書けて、コマンドの想定される出力と実際のものを比較してtrue/falseを判定するみたいなやつです。想定と実際の出力とのdiffがなければグリーン、期待と違えばレッドです。 Vagrantのテストというとserverspecが勢いありますが、cramはもっと生っぽいテストをかけます。serverspecではshould be_enabledのように、書くのは簡単だけど実際に何をテストしているのかはソースコードを見ないとわからないので、テストがこけた場合の原因調査がちょっと厄介です（例えばRedhat系ならchkconfigの結果を見ています）。とはいえcramでパッケージ
EvernoteのMarkdownをプレビューできるようにしたのでブログを引っ越した - orangain flavor
2016-01-14追記: BaraagはEvernoteアプリの仕様変更により動かなくなっています。Markdownでメモをとるのにリアルタイムプレビューは重要でないことに気づき、筆者も使わなくなっているので、メンテナンスする予定もありません。ごめんなさい。 今まではてなダイアリーでブログを書いてきましたが、はてなブログに引っ越しすることにしました。ブログを書くのをもっと楽にしたいと思ったためです。 その中で、EvernoteにMarkdown形式で書いたメモをプレビューする Baraag というツールを作ったので、ブログの書き方と合わせて紹介します。 これまでのブログの書き方 これまでは、Evernoteにはてな記法を混ぜつつ下書きを書いて、ある程度形になったら、はてなダイアリーで整形してから公開するというプロセスで書いていました。 この方式は、以下の点が気に入っています。 下書き時に
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
