軽量マークアップ言語の歴史をゆるく調べた #sphinxjp - kk_Atakaの日記
目次 はじめに 調べた人 まとめ 年表 考察 地味に苦労した点、、 reST setext(structure-enhanced text) StructuredText reStructuredText プロジェクトの推移 Markdown Markdown 更新終了後について CommonMark Wiki Wiki YukiWiki MediaWiki その他 はてな記法 終わりに おまけ: 参考サイト Markdown系 reST系 Wiki系 その他 はじめに reSTの成り立ちが気になったので、Sphinx+翻訳 Hack-a-thon 2015.07 - connpassを利用して調べてみた。 reST以外にも軽量マークアップ言語MarkdownとWikiもいくつかピックアップ。 reStructuredText structuredText(reSTの系譜を辿って見つけた)
実行ユーザの違いでJenkinsのホームディレクトリが変わって困った話 - kk_Atakaの日記
目次 あらすじ 環境 結論 コマンドプロンプトで実行したとき Jenkinsで実行したとき 原因にたどり着くまで あらすじ 結構昔にWindows 7上において、以下の2通りのSeleniumスクリプト実行結果が違ってすごく困っていた。 前提条件としては、Seleniumスクリプトは同じ。実行コマンドも bundle exec ruby hoge.rb で同じ。違うのは実行の仕方だけ。 コマンドプロンプトで実行 Seleniumスクリプト コマンドプロンプトからコマンド実行 正常終了 Jenkinsで実行 Seleniumスクリプト(「Windowsバッチコマンドの実行」でジョブに登録) リモートビルドから実行 ＼エラー／ 原因の切り分け方とかもわからなかったのでかなり苦戦…。 環境 Windows 7 Jenkins 1.581 Ruby 1.9.3 bundler (1.3.5) pi
kawasaki.rb #015 でSphinx導入事例の発表をしてきました #kwskrb #sphinxjp - kk_Atakaの日記
あらすじ kawasaki.rb #015 で発表してきたので、まとめ。 Kawasaki.rb #015 あわせて読みたい kawasaki.rb #013 でSphinx導入事例の発表をしてきました と #011 #012 参加記録 #kwskrb #sphinxjp - kk_Atakaの日記 本当は14回で発表したかったのだけど、病欠してしまった…。 発表内容 以下のスライドを元に発表しました。 SIerでもSphinxを使いたい！ 後編 from kk_Ataka 結論 結論としては、 やはり納品物にするには(歴史的経緯などから)厳しい 社内ドキュメントにする分には問題なし SphinxからOutputを出すのはいいけど、顧客に巻き取られた後変更に耐えうる形式じゃないとつらい チームで適用するには一人ではつらい(個人的なパワー不足) 最低でも一人賛同者がほしい こんな感じ。もっと
WindowsにSphinxのlatexpdfjaができる環境を整えるのに苦戦した話 - kk_Atakaの日記
あらすじ Windows に Sphinx から pdf を出力する環境を作成したが、 make latexpdfja コマンドを打つと途中で失敗する。 for f in *.pdf *.png *.gif *.jpg *.jpeg; do extractbb $f; done f の使い方が誤っています。 make: *** [all-pdf-ja] Error 255 環境 Windows 7 Python 2.7.6 Sphinx 1.2.2 e-pTeX 3.1415926-p3.4-110825-2.6 (sjis) (TeX Live 2013/W32TeX) kpathsea version 6.1.1 ptexenc version 1.3.1 結論 PYTHON_HOME\Lib\site-packages\SPHINX_HOME\sphinx\texinputs の下に
「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた2 - kk_Atakaの日記
前回のあらすじ 「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた - kk_Atakaの日記 かなり期間があいてしまったが、次に考えるは、実際にどうやって「導入」して「運用」するか。 「納品」するに当たってどんな問題があるか。 このあたり、良い前例があったら知りたいところ。 課題 課題はとりあえず2段階あると思っている。 第1段階: 対開発工程の課題 プロジェクトに対しての導入・運用方法 どうやって運用していくか。 ルール決め大事。 第2段階: 対納品工程の課題 納品形式 納品後修正が発生した場合どうするか 顧客(※)に対してどうやって納品するか、またそれをなおすのは誰？ (※) 顧客とは、納品したドキュメントを読む、使う、なおす人。社内の人かもしれないし、社外の人かもしれない。 一つずつ考えていく。 対開発工程 登場人物 以下、架空の登場人物とする。 リーダー :
Gitの.git/objectsの中身を追ってみる - kk_Atakaの日記
あらすじ この記事は Git Advent Calendar 2013 の 14 日目の記事です。 12 日目: @ton1517さん - gitのサブコマンドを自分で作る - ton-tech-ton 13 日目: @horimislimeさん - git mergeでコンフリクトが発生するか前もって調べる方法 - Qiita [キータ] 14 日目: ここ 15 日目: kyanroさん - git - rebase 直後に、自分が修正していたファイルが変更されたかどうかを調べる - Qiita [キータ] とりあえず 12 日目へつなげておきますね。 最近 Subversion を使うことが多く、めっきり Git を使っていないので、復習として .git/objects の中身を追ってみた。 参考 Pro Git 9章 Git - Gitの内側 アリスとボブのGit入門レッスン Ch
「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた - kk_Atakaの日記
あらすじ 今までちびちび触ってきたが「Sphinx をはじめよう」を読んで、改めて Sphinx を導入したいと考えた。 そこで、今の環境でどうやったら導入できるのか色々考えてみたが、相談できる人もいないのでここにアップしてみる。 本当は説得材料をつらつらと上げて「だから試してみよう」ってところに持って行きたかったんだけど、そこまでは行けていない。ダラダラ書いている。 テーマ 適材適所 決して Office ディスではなく。色々なツールが適材適所で LET US CLING TOGETHER できる道を考えたい。 結論 ドキュメント Sphinx 複雑な表や表計算が必要な資料 Excel で別添資料扱い？ その他こまい文書 Redmine とかの Wiki に書き換え って分けられると、幸せになれると考えている。。 Word は…思いっきり Sphinx と競合する気が…。 現在の己の認識
Sphinxのプラグインの作り方を学ぶ - kk_Atakaの日記
あらすじ Sphinx のタグを拡張してみたい。具体的には打ち消し記法がほしい。 という事で Sphinx 拡張に手を出す。 ただし、 Python は Hello World くらい…。 参考サイト Sphinx拡張 Sphinx v1.0.6 documentation Sphinx拡張 Sphinx 1.2b1 documentation 打ち消し線は既に実例があったので、これを写経する方針で。 Sphinxで打ち消し線を使う - TIM Labs 環境 Windows XP Python 2.7.3 Sphinx 1.1.3 と、 Windows 7 Python 2.7.4 Sphinx 1.2b.1 Sphinxの拡張の仕方 Sphinx 1.1.3 時に調べていた感じでは、拡張には大きく3通りある模様。 新出力形式対応やパース時のアクションサポート(ビルダー追加で実現) re
Sphinxをインストールしようとしたら全然関係ないproxy周りでハマった話 続き - kk_Atakaの日記
前回までのあらすじ Sphinxをインストールしようとしたら全然関係ないproxy周りでハマった話 easy_install で見に行く proxy の順番はこんな感じだった。 引数に明示的に指定した場合は引数を使う ↑を満たさず、環境変数 xxxx_proxy が設定されている場合はそこから読み込む ↑を満たさない場合、 Windows ではレジストリ( IE の proxy 設定)を見にいく で、なぜか環境変数 HTTP_PROXY を読み込んだ場合は失敗して、 HTTP_PROXY をクリアしてレジストリの proxy 設定を使ったら DL が成功しちゃったという話。 なんでか気になったので調べた。 結論 http 以外 の proxy 設定をしていなかったから。というマヌケなオチ。 次から気をつけよう。 レジストリ( IE の設定)から IE の 設定では、 ツール > インターネ
Sphinxをインストールしようとしたら全然関係ないproxy周りでハマった話 - kk_Atakaの日記
あらすじ Sphinx を導入しようとして Python周りの環境を整えていたら easy_install がやたら失敗したりして困った。 環境 Windows 7 Python 2.7 Python インストール …は、以前入れるだけ入れていた 2.7 があったので割愛。 Sphinx-Users.jp のインストール手順では 2.6 が使われていたので、 2.7 でも大丈夫そう。 環境変数 PATH に以下のパスを追加。 C:\Python27 Pythonのコマンドが含まれるフォルダ C:\Python27\Scripts 次に説明するeasy_installコマンドや、Sphinxのコマンドが格納されるフォルダ easy_install インストール(distribute_setup.py) Ruby でいうところの Bundler のようなもの？ setuptools - 清水川
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
