タグ検索の該当結果が少ないため、タイトル検索結果を表示しています。
Microsoft WordやMarkdownで文書ファイルを作成し、それをHTMLファイルやPDFファイルに変換したい時、形式ごとにいちいち変換ソフトを用意するのは面倒です。無料のオープンソースソフトウェア「Pandoc」を使うと、ありとあらゆる形式の文書ファイルを他形式の文書ファイルに変換することができます。 Pandoc - About pandoc https://pandoc.org/ GitHub - jgm/pandoc: Universal markup converter https://github.com/jgm/pandoc Pandocは2006年にリリースされた非常に長い歴史を持つ文書変換ツールで、2020年現在でも活発な開発が行われています。変換できる文書ファイル形式の多様さから研究者やエンジニアに広く支持されており、記事作成時点でPandocが対応している文
nb is a command line and local web note‑taking, bookmarking, archiving, and knowledge base application with: plain text data storage, encryption, filtering, pinning, #tagging, and search, Git-backed versioning and syncing, Pandoc-backed conversion, [[wiki-style linking]], terminal and GUI web browsing, inline images, todos with tasks, global and local notebooks, organization with folders, customiz
今回紹介するMarkdownやHTMLは当然として、reStructuredText、Textile、LaTeX、何故かCSV,EPUB、docx(Word)や、pptx(PowerPoint)、Jupyter notebook、各種Wiki形式、PDFに対応しています。 魅力②「メタデータや独自フォーマットへの豊富な対応」 Pandocは、Markdownのシンタックス拡張や、ドキュメントメタデータ、テーブル、脚注、箇条書き、上付き文字、下付き文字、順序付きリストに対応しています。文書変換時に、このあたりのフォーマット情報がきちんと変換されるのは心強い。 魅力③「定期的なアップデート」 Pandoc - Releasesを見るとわかりますが、ほぼ3ヶ月に一度ほど定期的に更新されています。最新のリリースは2020年2月15日と非常にフレッシュ! 自分実はPandoc自体は3年ぐらい前からそ
【roff形式を手書きは無理ゲー】manページをMarkdown + Pandocで作成【with manページお作法】 by nao · 公開済み 2020年12月19日 · 更新済み 2020年12月25日 前書き:manualページは伝統的なドキュメント manページは、UNIX系OSのドキュメントであり、コマンドやシステムコールなどの説明が記載されています。 Unix v7の時代(1979年)から変化が少ないため、2020年現在の視点で見ると表現力に難があります。具体的には以下のような欠点があり、manページを良質なドキュメントとするには文章力を試されます。 画像を挿入できない ハイパーリンク非対応 Terminalからしか参照できない(manページをHTMLに変換して公開しているサイトはあります) 勿論、manページより表現力が高いTexinfo、Docbookなどの代替ドキュメ
私の周りでは、情報管理にesaを使っている方が非常に多いです。 esaは私も使っていますが、以下のようなメリットがあり、とても便利です。 WIPの状態でも公開できる 情報の検索がしやすい 更新の履歴が追える 顧客との打ち合わせの議事録もesaにまとめるチーム・会社も多いそうです。 齟齬をなくすため顧客にも議事録内容を共有する際に、わざわざesaの内容をWordファイルに編集し直したり、それをPDFに変換している、という声をある方から聞きました。 それが面倒で、最初からWordファイルに書くようになり、esaなどで共有されなくなってしまった、という状態になっているそうです。 それはかなり無駄だと思うので、自動でWordとPDFファイルを自動生成ツールを作ってみました。 構成概要社内の特定のPCにWebサーバを立てて、皆がそこにアクセスしてツールを使えるようにしたいなと思いました。 特にこだわ
昨日の記事では、PandocのReaderを自分で作り直す話をしました。 いうまでもありませんが、ReaderはPandocの一部なので、改造Readerを使うためにはPandocをソースから自分でビルドする必要があります。 ところがPandocというのは、Haskellで書かれているうえに、かなり巨大で依存関係がめんどくさいソフトウェアです。 GitHubからソースをcloneしてくれば誰でもビルドできるとはいえ、Haskellの開発経験がまったくないと、ビルドできる環境を整えるだけでもなかなか大変でしょう。 Readerを改造するしか手のうちようがない機能追加や修正については何ともなりませんが、Pandoc構造に押し込まれたコンテンツを他の記法として書き出すときに標準とは違うことをしたいだけなら、Pandocをソースからビルドしなくても済むような裏口が昔から用意されています。 それが今
昨日までの記事では、Pandocフィルターの基本と少しだけ実用味がありそうな例を紹介しました。 Pandocフィルターは、Pandoc本体の開発言語と同じくHaskellで書けますが、Pandocの内部動作を変えられるわけではなく、pandocコマンドによってJSONとして出力したデータを操作する仕組みです。 内部に組み込まれたLua処理系で実行できる新しいフィルターの仕組みもありますが、いずれにしてもpandocというコマンドに対する補助的な機構です。 一方で、Haskellというプログラミング言語から見ると、Pandocはライブラリでもあります。 つまりpandocコマンドとしてでなく、自分が書くHaskellのプログラムで読み込んでそのMarkdownのパーサだけを使う、といったことも可能です。 今日はそのような事例を紹介します。 XML原稿にあるMarkdownの島 先週、このアド
この記事では、Pandocを使って日本語PDFを出力する方法について説明します。特にLaTeXをPDF変換エンジンに使う場合を想定します。 【以下では、TeX Live 2019 (scheme-full)がインストール状態を前提とします。 インストール方法は TeX Live - TeX Wiki を参照してください。】 (補足: TeX Live 2019以前でも構いませんが、後述のパッケージを利用するには、TeX Live 2016あたり以降が必要だと思います。あるいは tlmgrコマンドでTeX Liveをアップグレードしてください。) 日本語でふつうにLaTeXできないPandoc Pandocでは和文を含む入力文書を、普通にPDFへ変換する(-o foo.pdf)とエラーになります。Pandocが使うPDF変換エンジン(--pdf-engineオプション)は、デフォルトでpdf
これは「TeX & LaTeX Advent Caleandar 2020」の23日目の記事です。 22日目は、MusicDumpさんでした。24日目は、7danmoroboshiさんです。 みなさん、#テフライブ! していますか? ここ最近、「Markdown原稿からPandocしてLaTeX組版する」一連の処理で、書籍製作することが増えてきました。 例えば、某弊社で製作させていただきました事例をいくつかあげます。 Andriy Burkov[著]、清水美樹[訳] 『機械学習 100+ページ エッセンス』(インプレス) David Thomas・Andrew Hunt[著]、村上雅章[訳] 『達人プログラマー 熟達に向けたあなたの旅(第2版)』(オーム社) 内田智史[監修]、株式会社システム計画研究所[編] 『C言語によるプログラミング -基礎編-(第3版)』(オーム社) 田中祥平[著]
ご存じの通り、Markdownにおいては「入力における段落1内の改行は改行にならずに空白と解釈される」という規則があります2。例えば、次のようなMarkdown文書3があったとします。 All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood. これが表すのは次のような“改行のない1つの段落”です。もちろん、実際に出力される際には行長に応じて(「なりゆき」で)適宜改行が入ります。 All human beings are born free and equal in dignity and rights. The
トップページ お役立ち記事 Wordより楽に、本格的な文書作成 Pandoc Markdown はじめに 意外とストレスになっている「Wordで文書」 文書作成、というとコンピュータがビジネスに導入されたごく初期からある用途です。 それが市民権を得た時には「ワープロ」と呼ばれる専用機が人気でしたし、その後には”Microsoft Word”, “JUSTSYSTEM 一太郎”, “Lotus WordPro”のどれが良いかという不毛な派閥争いが行われたこともありました。 しかし現在は事実上Microsoft Wordの一強と言えるでしょう。一太郎を使っていると時代遅れな職場だと批判されるくらいです。 意識の高いところであればLibreoffice Writerを使っているところもあるかもしれませんが、それもだいぶ稀ですし、基本的にLibreoffice WriterはMicrosoft W
これで全部ではないし、どちらかといえばPandocユーザーズガイド日本版に記載されているものはそれを読むほうが早いので、記載されていないものを中心にあまり知られていないものを集めてみた。 上付き文字 (superscript) ^ではさむ。
Wordで組版をしていくにあたって、Wordのアプリケーション上で文章やサンプルコードを入力していくのは現実的ではありません。 見出しのスタイルを当てたり、シンタックスハイライトを手動で当てていくのはMarkdownになれた人間がやるべきことではありません。ツールにまかせるべきです。そこで利用するのがPandocというツールです。 > はじめてのPandocはじめてのPandoc > Pandocとは?Pandocとは? Pandocはドキュメントの形式を変換するツールで、MarkdownやPDF、ePub、Wordなどの多くのフォーマットに対応しています。今回は、MarkdownからWordに変換する用途でPandocを利用します。 Pandoc - About pandoc > PandocのインストールPandocのインストール Pandocは公式サイトからインストールします。 ター
作業マシンが変わるたびに毎回同じものを作ってる気がするので、メモしておく。 我々はすべてのドキュメントをプレーンテキストで、つまりMarkdownで書きたいが、人は必ずしもそうではない。 折り合いをつけるためには、読めないからWordで書いてくれと言われてしまう前に、いい感じのアウトプットを出さねばならない。 ここでは html ファイルへのコンバートを考える。 md → html の変換は Pandoc を使えば簡単だが、毎回コマンド一発で使えるようにしておくにはちょっと準備が必要。 環境 Windows 10 Home Pandoc をインストールしておく CSSの用意 いい感じのスタイルで出力するには、いい感じのCSSが必要。 ここでは GitHub スタイルのCSSを利用することにする。 以前は ↓こちら Github Markdown CSS - for Markdown Edi
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、MarkdownからHTMLでもPDFでも、Wordにだって出力できて便利ですね。 軽い気持ちでPandocを導入しようとしたら地獄を見たのでその備忘録です。 なお、筆者の環境は Windows10 Pro + Docker for Windows で構築しています。 Linux歴3週間程度のため、コマンドの打ち方等は未熟な部分がありますのでご容赦ください。 2020/7/27 17:00 更新 HTMLの見出しの採番用Luaフィルタを追加 github.com リポジトリを作成しました。 目的 概要 手順 Docker (Docker for Windows)をインストールする pandoc/latexイメージを導入する LuaTeXパッケージ等導入する 図表対応のため pandoc-crossref を導入する easy-pandoc-templatesを導入する Doc
この記事は,Pandoc Advent Calendar 2019 の18日目の穴埋め記事です. 17日目の記事は,mitixxさんによるmarkdownで技術書を書いてpandocでpdfやicml(indesign)に変換するでした. 19日目の記事は,sky_yさんによるPandocの比較的簡単なインストール方法の大幅改訂版です. 本記事では,Pandocユーザーを増やすことを目的に,MarkdownやPandocなどに親しみのない研究者層に対して,MarkdownとPandocで論文を執筆する利点について紹介します. また,論文でよく使う書式やフォーマットに関して,具体例を紹介します. 本記事を読むことで,PandocとMarkdownで論文を書こうかな,と思ってくれる研究者が周りに増えれば嬉しいです. 研究者にとってアカデミックライティングは必須の仕事である 職業研究者として生き
この記事は Pandoc Advent Calendar 2019 の9日目です。 現在登録されている次回は、12/12の高見知英さんです。 (カレンダーの前後に空きがあります。今後の追加登録はもちろん、空いてる過去の日へも後追い参加も歓迎します!) 文書変換ツール Pandoc のバージョン 2.8 が2019年11月22日にリリースされました。 (2019年12月9日時点のPandoc最新バージョンは2.8.1です) Pandoc 2.8 では、Defailt files (-d / --defaults) という機能が追加されました。 今回はこの機能について説明します。 Pandocの地味なつらさ:オプションが長い Pandocを“まともに”使うと、pandocコマンドに与えるオプションがだんだん長くなってきます。 たとえば、日本語で書かれたMarkdown文書をPDFに変換したいと
Click to expand changelog Split pandoc-server, pandoc-cli, and pandoc-lua-engine into separate packages (#8309). Note that installing the pandoc package from Hackage will no longer give you the pandoc executable; for that you need to install pandoc-cli. Pandoc now behaves like a Lua interpreter when called as pandoc-lua or when pandoc lua is used (#8311, Albert Krewinkel). The Lua API that is avai
As you might know, I’m writing a book called Compiling to Assembly from Scratch. Recently I tweeted about my book-writing setup, and there was a lot of interest in the details of my setup. I’m only halfway through with writing the book (or, so I think), so my setup will likely to change as I go. But here it is, anyway. A screenshot: I’m on macOS, so I’m using the native full-screen split functiona
Python界隈でよく見かける構造化文書のための記法として、reStructuredText(以降はreSTと書きます)があります。 reStructuredText https://docutils.sourceforge.io/rst.html 軽量マークアップ言語などと呼ばれることもありますが、reSTはかなり高度な表現力がある記法です。 その記法をパースするために標準で使われているのはDocutilsという仕組みです。ただ、DocutilsはreST専用ではなく、他の記法のパーサを実装することもできるらしいです。 その意味でDocutilsは、Pandocと同じく、内部の抽象的なデータ構造へと記法を押し込めるツールだといえる気がします。 Docutilsについては『マスタリングDocutils』に詳しいので興味がある方は購入しましょう。 『マスタリングDocutils』 マスタリン
これまでテキスト執筆・電子書籍制作環境を色々と試してきました。快適な環境を模索し続け、ようやく「これが理想に近いかな?」と思える環境、 「VSCode + pandoc」 に行き着きました。 ・iBooks Author(Mac専用) ・Scrivener (Mac/Windows) ・Sigil(Windows/Mac/Linux) ・VSCode + pandoc (Windows/Mac/Linux) ←今ここ VSCode・EPUB制作モードこれが現在の私のVSCodeのEPUB制作モードです↓。ようやく理想的な環境が構築されつつあります。 VSCode・EPUBモードのメリット ・マークダウン書式で書ける ・VSCodeなのでEmacsキーバインドを使って書ける ・右側ペインにEPUBでのレンダリングをリアルタイム表示 ・左側のビューワーでファイル管理 ・下段にTerminalで
文書変換ツール Pandoc についてのAdvent Calendarです。Pandocやその周辺ツール・対応フォーマットに少しでも関わっていればOKです。 テーマ例 好きなPandocの使い方、ノウハウ、体験談(初心者歓迎!) おすすめ設定、執筆やドキュメント生成に便利なスクリプト・プロジェクト構成 Pandocハック(Pandoc Tricksみたいなやつ) Pandocフィルタ:書いてみた、便利なフィルタ見つけた Pandocが対応する文書フォーマット・マークアップ言語にまつわる話題 例:Markdown(各種方言)、reSTやOrgなどの軽量マークアップ言語、LaTeX・Word docx(OOXML)・LibreOfficeなど 参考 Pandoc - Pandoc User’s Guide (新・工事中)Pandocユーザーズガイド 日本語版 翻訳作業中・未完成です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く