【问题标题】:How to have multiple markdowns in the same gist如何在同一个要点中有多个降价
【发布时间】:2021-04-07 03:30:39
【问题描述】:

我想创建一个要点,我可以在其中展示一个包含一组链接的主要 Markdown 文档。这些链接将指向实际包含代码示例和技术说明的二级降价:

Here's 到目前为止我所拥有的。我已经包含了两个降价文件:

  • Notes.md:包含现有二级降价文档的列表
  • tree_traversal.md:这种二次降价的例子

如您所见,我尝试使用以下语法将Notes.md 中的链接添加到tree_traversal.md

example of a [link](tree_traversal.md)

但是有两个问题:

  1. Gist 服务器尝试同时显示Notes.mdtree_traversal.md。这不是我想要的。我想先显示Notes.md,然后点击链接导航到tree_traversal.md
  2. 当我实际单击在 Notes.md 中创建的链接时,我收到 404 Page not found 错误。

是否可以有这样的多页要点?如果有怎么办?如果不是,gist 是否仅设计为具有一个降价文件?

【问题讨论】:

    标签: github markdown gist


    【解决方案1】:

    将鼠标悬停在tree_traversal.md 标题上,我们看到它是一个链接

    https://gist.github.com/awa5114/4052ba8adb51779192a4a715a048f8ca#file-tree_traversal-md
    

    尝试在Notes.md 中简单地链接到#file-tree_traversal-md。这应该可以让您在文件之间进行链接,尽管它们仍然会在一个视图中呈现。

    Gists 是为快速 sn-ps 而设计的,而不是文档。也许您正在寻找GitHub wikis? Wiki can be cloned via Git, managed locally, and pushed back,他们一次只呈现一个页面。

    或者可能是GitHub Pages,可以用来托管静态网站?

    【讨论】:

    • 我不知道 GitHub wiki 是否是我正在寻找的。它们似乎是为软件文档设计的,而这并不是我真正想要做的。我正在尝试建立一个博客或小型网站,我可以在其中记录我正在做的事情和解释,以便 1)我可以稍后再回来 2)以便其他人可以与之互动并提供反馈,如果他们喜欢。我看过一些使用 Medium.com 的示例,但我有点想要一些可以更好地控制网页结构及其内容的东西。我可能只需要学习建立自己的网站:
    • @user32882,然后可能是GitHub Pages?我会将其添加到我的答案中。
    猜你喜欢
    • 1970-01-01
    • 2017-12-03
    • 2019-02-22
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多