Memo/pandoc

https://dexlab.net:443/pukiwiki/index.php?Memo/pandoc
 

pandoc ドキュメント変換


Backlog wikiからMarkdownへの変換

Pukiwikiっぽいが少しだけ違う。


ConfluenceからMarkdownへの変換

  • pandoc 2.9ではオプションが変わっているので「gfm」の方が良さそう
    • Confluence-html-to-github-markdown.js
      - var command = "pandoc -f html -t markdown -o " + outputFile + " " + p
      + var command = "pandoc -f html -t gfm -o " + outputFile + " " + p
  • anyenv + nodenv + node 12.14.1の場合のパス
    ~/.anyenv/envs/nodenv/versions/12.14.1/lib/node_modules/confluence-to-github-markdown/Confluence-html-to-github-markdown.js
  • install pandoc: Pandoc - Installing pandoc
    • Ubuntu 18.04 LTS
      wget https://github.com/jgm/pandoc/releases/download/2.9.1.1/pandoc-2.9.1.1-1-amd64.deb
      sudo dpkg -i pandoc-2.9.1.1-1-amd64.deb
      
      pandoc -v
      pandoc 2.9.1.1
  • install confluence-to-github-markdown
    npm install -g confluence-to-github-markdown
    • CLIとして実行できない場合、PATHが設定されていない。nodenvを使っている場合は「eval "$(nodenv init -)"」が必要
  1. ConfluenceのDashbord > Spaces から変換したいspaceを選択
  2. 右上の Browse > Advanced
  3. Export > HTML Export
    • Normal Export
  4. Export実行
  5. zipを展開
    unzip example.zip
  6. 変換処理: Markdownディレクトリが作られる
    confluence-to-github-markdown ./example/ assets/images/ assets/images/

pukiwiki形式へ変換


Markdown(GitHub)からtextile(redmine)へ変換

  • pandoc 2.9.1.1
    • gfmへ変わった
    • -S/-smartが廃止されて、「-f gmf+smart」のように指定する
  • pandoc 1.14
    • markdown_github
# pandoc 2.9.1.1
pandoc -f gfm+smart -s README.md -t textile -o README.textile

# pandoc 1.14
pandoc -f markdown_github -s -S README.md -t textile -o README.textile

インストール

  • Linuxバイナリ: 2.2.3.2
    • pandoc, pandoc-citeproc だけなのでオススメ
      wget https://github.com/jgm/pandoc/releases/download/2.2.3.2/pandoc-2.2.3.2-linux.tar.gz
      tar xvfz pandoc-2.2.3.2-linux.tar.gz
      sudo cp pandoc-2.2.3.2/bin/* /usr/local/bin/
  • MacOS X:
    brew install pandoc
    pandoc --version
    pandoc 1.17.2
  • CentOS7.x: epelのバージョン 1.12.3.1
  • CentOS6.x: epelのバージョンでは、markdown_github 非対応だった
    sudo yum install pandoc --enablerepo=epel
    pandoc --version
    pandoc 1.9.4.1

トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2020-10-14 (水) 19:03:10 (5d)