作業マシンが変わるたびに毎回同じものを作ってる気がするので、メモしておく。 我々はすべてのドキュメントをプレーンテキストで、つまりMarkdownで書きたいが、人は必ずしもそうではない。 折り合いをつけるためには、読めないからWordで書いてくれと言われてしまう前に、いい感じのアウトプットを出さねばならない。 ここでは html ファイルへのコンバートを考える。 md → html の変換は Pandoc を使えば簡単だが、毎回コマンド一発で使えるようにしておくにはちょっと準備が必要。 環境 Windows 10 Home Pandoc をインストールしておく CSSの用意 いい感じのスタイルで出力するには、いい感じのCSSが必要。 ここでは GitHub スタイルのCSSを利用することにする。 以前は ↓こちら Github Markdown CSS - for Markdown Edi
ちょっとしたドキュメントはMarkdownでささっと書いて HTMLやPDFに変換したいなということでPandocを使ってみることにしました。 Pandoc Pandoc自体は様々な形式に対応しているようです。 $ pandoc -h pandoc [OPTIONS] [FILES] Input formats: native, json, markdown, markdown_strict, markdown_phpextra, markdown_mmd, rst, mediawiki, docbook, textile, html, latex Output formats: native, json, docx, odt, epub, epub3, fb2, html, html5, s5, slidy, slideous, dzslides, docbook, opendocume
MarkdownファイルをPandocでHTML化する際、どのような指定が良いかを迷っていたのですが、いまのところ以下のようなオプションで落ち着きました。 HTMLテンプレート Table of Contents(TOC)の作成 画像ファイルの同梱 $ pandoc \ --standalone \ --self-contained \ --resource-path=/path/to \ --toc \ --toc-depth 2 \ --shift-heading-level-by=-1 \ --metadata title='タイトル' \ --template=html_templates/bootstrap_menu.html \ --fail-if-warnings \ --output=${destdir}/guide.html \ /path/to/target.md HT
メモ pandocの環境をいちいち構築するのがだるすぎるので、Pandocのdockerイメージを使ってMarkdownからHTMLに変換する。 docker導入は以下を参照。 https://qiita.com/tsnb/items/d10d2770c08abc60b500 環境 dockerは入っている前提。 - CentOS 7(Core) - docker 17.09.0-ce - proxyあり - firefoxで確認 $ ./pandoc.sh test.md $ ls test.md(入力) test.md.html(吐き出されるhtmlファイル) github.css(変更したもの) 38c38 < background: url("../../images/modules/styleguide/para.png") no-repeat 10px center; ---
Clipping16AI1Camera1Lighting1Cloud1Database1Kafka1List1Research1Management2PostgreSQL1Stream Processing3Uber1Vim2Windows Tools1Home server14File server1Hardware1Nature Remo1Network1Remote desktop1Ubuntu8Adobe Reader1Gnome1KVM3OneDrive1vim1Video processing1Knowledge Management159Alluxio1BaaS1Configuration Management2Ansible2Data Catalog1CKAN1Data Collaboration6Delta Sharing4X-Road1Data Engineering3
pandocを使ってMarkdownをepubにする方法と場所 の続きです。 ちなみに、pandocとは、こういうことができるツールです(興味のある人は、ググってインストールして下さい)。 PandocでMarkdownをHTML形式やらWord形式に変換する それはさておき。 githubの最初のページに出てくるREADME.mdのフォーマットって、かっこいいですよね。 その上、Markdown言語で書くので、とっても簡単です。 今まで、Latexとか、htmlの記述で苦労してきたのがバカみたいです(まあ、技術系の記述だから、という理由もあると思いますが) だから、このgithubのイメージをそのままにして、書籍化(epub形式)できないかな、と思っていたら、スタイルシートを変えるだけで行けました。 "github.css"で検索したら、色々出てくるようですが、私は以下のファイルを、"g
環境準備 Pandoc のインストール Releases · jgm/pandoc · GitHub 最新版の Pandoc-x.yy.z-windows.msi をダウンロード&インストール 使い方 基本 pandoc <元となるファイル> -o <出力ファイル> 「-o」は、出力ファイルの拡張子を見て、自動判断してくれるので、便利! なるべく自動判断したほうが、ヒューマンエラーが少ないのでオススメ! Markdown → HTML 基本で説明したやり方でもできるけど、タイトルにあることがしたいので、そのやり方を説明。 pandoc <変換元Markdownファイル> -s --self-contained -t html5 -c github.css -o <出力されるhtmlファイル> ※--self-containedは、CSS やスクリプト、画像ファイルを全て埋め込む方法。 gi
(更新:2023年6月10日) 私はよくTwitterでPandocをキーワードに検索するのですが、 Pandocのインストールについて「失敗した」「難しい」という声をよく聞きます。 実際には、Pandocはなじみ深いインストーラでインストールできます。 またコマンドラインでのインストールも、思ったよりも難しくありません。 (おすすめの方法には「★」を付けています。よければ参考にしてください) ★マウスで簡単:Pandoc公式インストーラを使う 【Pandocバージョン:最新】 最も簡単な方法はこれです。 コマンドラインにあまり馴染みのない方は、インストーラを使うことをおすすめします。 まず、下記のダウンロードページに行きます。 リストの中から、自分のOSに合ったものを選んでください。 (3.x.xの部分はバージョン番号なので、その都度変わります。バージョンは最新版・一番上のものを選んでく
動機 ただ何となくふとやってみたいと思っただけです。 準備 ~/.pandoc ディレクトリを作成 github.css で画像を参照している箇所を https://raw.githubusercontent.com/gollum/gollum/master/lib/gollum/public/gollum/images/para.png https://raw.githubusercontent.com/gollum/gollum/master/lib/gollum/public/gollum/images/dirty-shade.png に差し替え ~/.pandoc 直下に上記 CSS ファイルを配置 ここに改変済みの CSS を置いておきます。 実行例 ポイントは --self-contained です。CSS やスクリプト、画像ファイルを全て data: URI スキームを使って
github.css � �HV ��9�HV body { font-family: Helvetica, arial, sans-serif; font-size: 14px; line-height: 1.6; padding-top: 10px; padding-bottom: 10px; background-color: white; padding: 30px; } body > *:first-child { margin-top: 0 !important; } body > *:last-child { margin-bottom: 0 !important; } a { color: #4183C4; } a.absent { color: #cc0000; } a.anchor { display: block; padding-left: 30px; margi
印刷出力 pandoc を使用することで、様々なファイルフォーマットに出力可能です。 複数の Markdown ファイルを結合して、 pandoc に渡すことで、 1枚の PDF ファイルに出力することができます。 PDF出力 まず、体裁を整えるため、 preanble.tex ファイルを作成します。 % % preanble.tex % PDF出力用プリアンブル % \paperwidth210mm \paperheight297mm \usepackage{luatexja} \usepackage[ipa]{luatexja-preset} \usepackage{amsmath} \usepackage{graphicx,color} \usepackage[margin=2cm,truedimen]{geometry} \def\baselinestretch{1.1} \par
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く