【问题标题】:How make a better markdown for developer blog如何为开发者博​​客做出更好的降价
【发布时间】:2010-12-05 04:17:41
【问题描述】:

我正在http://www.elmalabarista.com/blog/ 重建我的博客。我在以前的版本中使用过降价,现在我记得为什么我的代码示例几乎为零。在 Markdown 中做代码示例非常脆弱。

我尝试将一些 python 放在那里,但无法将其标记为代码!罪魁祸首?代码的语法是降价的,没有空格。尽管我使用 wmd 作为编辑器(在 SO 中的工作方式对我来说是一个谜),但它永远无法正确移动文本,因此永远不会获得代码。这就是问题所在:

我说的很简单:

:::python
def hello():
   pass

但问题是我有一些东西:

:::python 定义你好(): 通过

:::python 定义你好(): 通过

(是的,机器人已格式化,但你看到了吗?不起作用)。任何错误——使用制表符、太多、太少的空格)都会受到严厉的惩罚。如果代码很长,出现问题的机会也会增加。

所以,存在任何简单的方法:

###我的文章

  1. 我的列表条目一
  2. 我的列表条目二

:::python 定义 x (a, b): 返回一个* b

并得到正确的转换,不再为这个小事烦恼???

顺便说一句,我正在使用 pygments & python markdown。

【问题讨论】:

    标签: python markdown code-formatting


    【解决方案1】:

    考虑使用reStructuredText——它是 Python 的标准轻量级标记,通常用于文档字符串和嵌入式文档。它很简单,但也很强大——如果我没记错的话,核心 Python 库和 Django 都使用它。

    【讨论】:

    • 是的,结合 sphinx (sphinx.pocoo.org) 这是一个很棒的工具。如果我没记错的话,Doug Hellmann (doughellmann.com/PyMOTW) 提到他使用 rest/sphinx 作为本周博客的 Python 模块。
    • reST 附议。用 Python 实现的 docutils 库非常友好,易于理解和扩展
    • 但是有同样的问题。我关注codekoala.com/blog/2008/…,仍然需要将每一行代码精确缩进到格式化工作中。所以,没有糖果。
    • 我不明白。问题是代码块的语法使用缩进?如果是这样,最好的解决方案是在编辑器中添加一个宏来缩进四个空格。然后你只需粘贴代码清单,选择它,缩进,它就可以工作了。
    • 不工作时除外!我尝试粘贴 6 次,然后 完全 正确。几行代码很简单,但对于长代码来说不是那么可靠......
    【解决方案2】:

    我一直在使用google-code-prettify,效果很好。

    Usage

    将代码 sn-ps 放入

    ...
    ... 会自动打印出来。

    【讨论】:

    • 好的,但是我用markdown格式化代码。如果我使用这种 f JS 解决方案,我将需要手动删除 html 标签,而不是使用纯文本内容。
    • 你可以将标准的html标签放在markdown中,markdown不会弄乱它们……那为什么不呢?
    【解决方案3】:

    您需要缩进超过 4 个空格的代码(顺便说一句,如果您添加 4 个空格,它会被识别为代码),这是 4 个空格缩进:

    :::python
    def hello():
        pass
    

    【讨论】:

      猜你喜欢
      • 2013-06-08
      • 2017-02-02
      • 1970-01-01
      • 2010-09-28
      • 1970-01-01
      • 1970-01-01
      • 2020-10-13
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多