RST (restructuredtext) で書かれたRobot Frameworkのユーザー ガイドを Markdown に変換して、 mkdocsサイトとしてこの素晴らしい作業をホストできるようにしたいと考えています。ガイドの html バージョン (こちらを参照) をpandocで変換しようとしましたが、結果は私が望んでいたものではありませんでした。
ここで、 HTML バージョンのユーザー ガイドを生成するために使用される元の RST ファイルを変換してみます。ユーザーガイドのソースは、いくつかの RST およびその他のファイルで構成されています
- 役割.rst
- ユーザーガイド.css
- RobotFrameworkUserGuide.rst
- サブフォルダー内の .rst ファイルの束
pandoc などのツールを使用して、構造全体を一度に変換することはできますか?
変換後の手動編集の必要性を可能な限り低く保つ方法で、RST ソースを Markdown に変換するためにどのような手順を実行することをお勧めしますか? )?