代码之家  ›  专栏  ›  技术社区  ›  Jared Wilber

渲染内部标记文件的输出。rst文件

  •  14
  • Jared Wilber  · 技术社区  · 8 年前

    Sphinx 用于记录Python项目,并希望从现有 .md 文件显示在 .rst 文件 (我已经设置了 conf.py

    tutorial.md . 我还有一个 .rst公司

    ml
    ==
    
    w2v
    ^^^
    
    .. automodule:: package.ml.w2v
    :members:
    

    我想能够包括一个链接到 如下所示 辅导的医学博士

    ml
    ==
    
    Tutorial
    --------
    .. include:: ../tutorial.md
    
    w2v
    ^^^
    
    .. automodule:: package.ml.w2v
    :members:
    

    但是,生成的内容看起来很糟糕,因为它不会将降价渲染为降价。

    ,但这个练习给我留下了以下问题:

    有没有可能 .医学博士 内容呈现为降价, 在…内 .rst公司 文件

    1 回复  |  直到 6 年前
        1
  •  18
  •   Jared Smith    5 年前

    注释

    这个 mr2 延期似乎被放弃了。您可以使用主动维护的fork m2r2 相反

    M2R 狮身人面像延伸。

    https://github.com/miyakogi/m2r#sphinx-integration

    安装m2r并更改conf.py后,只需更改 .. include .. mdinclude 效果会很好。

    ml
    ==
    
    Tutorial
    --------
    .. mdinclude:: ../tutorial.md
    
    w2v
    ^^^
    
    .. automodule:: package.ml.w2v
    :members: