# -*- coding: utf-8 -*- --- :head: - hikiutil関連のヘルプ :initialize: :opts: :short: "-i" :long: "--initialize" :desc: hikiで卒論を書くときの初期化と掟 :title: hikiで卒論を書くときの初期化と掟 :cont: - 開発メモ:figs,dataも作成 - 目的:西谷が後で迷わないように決まったファイル構造を堅持すべし - 文書:hikiで書く.のちには,latexに変換するプログラムを提供します - 図表:すべての図表をkeynoteにまとめる,タイトルを分かりやすく書く - データ:dataディレクトリにまとめる.ファイル名をkeynoteの対応する図表中に記す - hiki --initializeで初期ファイル(Rakefile, ./.hikirc, hiki_help.yml)がcopyされる - hiki_help.ymlを適宜~/.my_helpにcopyしてhiki_helpとして利用,(my_help参照) - Errno::EACCESやpermission errorがでたときはrake chenvを試してみる(報告して) - rake syncによってhikiディレクトリーと同期が取られる - hiki -u TARGETによってブラウザー表示される - テキストの拡張子は'.hiki' - hikiでのurlはテキスト名とディレクトリーから自動生成される - 例えば,hiki2latex_saki/introduciton.hikiはhiki2latex_saki_introducitonと変換される :error: :opts: :short: "-e" :long: "--error" :desc: error対応 :title: error対応 :cont: - Permission denied - ./data/text/boundary_narita (Errno::EACCES)->テキストにhikiが書き込めない,chmod a+w FILE - rake chenvを試してみよ :figs: :opts: :short: "-f" :long: "--figs" :desc: 図表に関する制約 :title: 図表に関する制約 :cont: - すべての図表をkeynoteにまとめる - keynoteに書いたスライドはイメージに書き出して,rake convert 80 TARGET_DIRでfigsに変換 - rake syncでfigsにあるfilesはhiki/target_dirにcpされる - 'convert #{source} -resize 20% #{target}によって,target=figs/TAERGET.pngに20%に縮小して保存される' - "convert -density 300 view.svg view.pngで300dpiで変換" - "attach_anchorでは'{{attach_anchor(test.png, hiki2latex_saki)}}'と,directory指定しなければならない." - keynoteであとで図を挿入して番号が変わった時の原稿の一括変換 - rake increment 2 boundary_bob.hiki boundary_bob > tmp.hiki - rake convert 60 boundary_bob - rake sync - hiki -u boundary_bob_tmp :sync: :opts: :short: "-s" :long: "--sync" :desc: hikiとの同期に関する制約 :title: hikiとの同期に関する制約 :cont: - hikiシステムはフラットなdirectory構造を取っている - hikiの文書はスネーク表記(例えば,latex2hiki_saki)で階層構造に似せている - hikiのurlの接頭語となる名前をbasenameのdirectory名とする. - directory名が'hikis'である場合はその親directory名となる. - ~/.hikircのtarget directoryを同期先のdirectoryとする. - ~/.hikircがない場合は同期先のdirectoryを聞く. - それらは./.hikircに保存される :text: :opts: :short: "-t" :long: "--text" :desc: テキストに関する制約 :title: テキストに関する制約 :cont: - "テキストの拡張子は'.hiki'としている" - hikiでのurlはテキスト前とディレクトリーから自動生成される - "例えば,hiki2latex_saki/introduciton.hikiとするとhiki2latex_saki_introducitonと変換される" :latex: :opts: :short: "-l" :long: "--latex" :desc: latexに関する制約 :title: latexに関する制約 :cont: - latex_dirに対応するtexファイルが作られる - head.texにlatexのtitle部を記述 - "ref:図{{ref(fig:SystemOverview)}}に卒論編集システムの概観を示しています." - "!!!caption: (fig:SystemOverview)卒論編集システムの概観." - "caption以下の丸括弧内にタグを書く" - "fig:以下のタグにsnake nameは使えん.Camelで書く" - "cite:基本的な使い方{{cite(listings1)}}" - "!reference:" - ":listings1:[[http://d.hatena.ne.jp/mallowlabs/20061226/1167137637]]" - "reference:以下の:...:記述がlatexではbibliographyに変わる"