Pdf

github wikiからの簡単なエクスポート(?)



Effortless Export From Github Wiki



解決:

しかし... GitHubリポジトリのGithubwikiは、それ自体がgitリポジトリです(2010年8月に導入されました)。

クローンを作成したり、プッシュしたり、プルしたりできます。



各ウィキはGitリポジトリであるため、他のウィキと同じようにプッシュおよびプルできます。
各ウィキは、ソースリポジトリと同じ権限を尊重します。
'を追加するだけです.wiki 'をURL内の任意のリポジトリ名に 、そしてあなたは行く準備ができています。

それはあなたの質問の「エクスポート」部分を本当に些細なものにします。



そこから、マークダウンページをPDFに変換するための大量のスクリプトが見つかります。

  • グラドルタスク
  • makefile
  • Pythonスクリプト
  • ..。

新しい読者に役立つ場合に備えて、この回答に追加します:)これが私がしたことです:

GitHubデスクトップをインストールしました:https://desktop.github.com/



次に、リポジトリのwikiページで、[デスクトップにクローンを作成]をクリックしました。

これにより、Wikiが.mdファイルとしてローカルに保存されました(画面の手順を実行した後)

次に、http://www.markdowntopdf.com/を使用してPDFに変換しました(注:ファイル名を変更して、PDFファイル名で機能しない文字を削除しました ウェブサイトへのアップロード)

最終結果は本当に素晴らしかった。


ソリューションの多くを再現するのが難しい/正しいバージョンを取得する/理解する/修正するなど...代わりに、5のWindows(git bashを使用)/ MacOS / Linuxで簡単に変換するパッチワークDockerソリューションを紹介します「簡単な」コマンド

git clone {project_url} .wiki。 #実際のgithubパイプラインdockerrunを使用して* .mdを* .md.htmlに変換します--rm-e DOCKER_USER_ID = `id -u` -e DOCKER_GROUP_ID =` id -u`  v'`pwd`:/ src'- v'`pwd`:/ out 'andyneff / github-markdown-preview#wkhtmltopdfはgithubサーバーよりも厳密であるためハイパーリンクを修正docker run --rm -v` pwd`:/ src -w / src perl  perl -p- i -e's |( 。*? )|  1  L  2  E.md.html  L  3  E  4 | g ' * .html#ハイパーリンクがdocker run --rm -v `pwd`:/ srcと一致するようにすべてのファイル名を小文字にします-w / src python  python -c'import sys; import os; [os.rename(f、f.lower())for f in sys.argv [1:]] ' * .md.html #QT webkit docker run -it --rm -e DOCKER_USER_ID =を使用してhtmlをpdfに変換します`id -u` -e DOCKER_GROUP_ID =` id -u`  -v `pwd`:/ work -w / work andyneff / wkhtmltopdf  wkhtmltopdf --encoding utf-8 --minimum-font-size 14  --footer -left '[date]' --footer-right '[page] / [topage]'  --footer-font-size 10  toc  * .html document.pdf

Perlは、より良い解決策なしでは失敗する可能性のある主要な部分です。 Pandocには非常に優れたフィルターソリューションがありますが、githubパイプラインを使用していません。

バグ

  • 非常に幅の広いコードブロックはスクロールバーでレンダリングされ、基本的にPDFで切り取られます。コードブロックがオーバーフローしないようにするのが最善ですが、追加することもできます--user-style-sheet user.css to the wkhtmltopdf command(beforetoc /カバー)、そしてあなたに追加しますuser.css

    .markdown-body .highlight pre、.markdown-body pre {overflow:visible!important; }
  • 最終的なPDFの一部のリンクは、+ 1ページずれていますが、そうでないものもあります。パターンが何であるかわからない。ただし、ID(#)を持つアンカーにはこの問題はないようです