• 请不要在回答技术问题时复制粘贴 AI 生成的内容
arobota
V2EX  ›  程序员

作为资深 md 工程师,安利一个高颜值的文档神器

  •  
  •   arobota · May 23, 2020 · 4792 views
    This topic created in 2354 days ago, the information mentioned may be changed or developed.

    material mkdocs

    又好看,又好用,我都用这个部署博客了

    https://www.leosirius.fun/

    另外打个广告:leetcode 题解,几乎每题都有解题思路和单元测试,不断补充中 https://github.com/LeoSirius/leetcode_solutions

    11 replies  •  2020-05-24 20:42:49 +08:00
    yazoox
    yazoox
    May 24, 2020
    1
    md 工程师?专业写文档?
    whileFalse
    whileFalse
    May 24, 2020
    2
    哥们你这个主页……真是……丑哭了……
    还有就是那个工具,找了 10min 没找到 mkdocs.yaml 的入门写法,于是我流失了。

    一个优秀的新手向导是什么样的?在有一堆 md 文件的目录下执行一条命令即可启动(使用 docker );
    entrypoint.sh 发现没有配置文件,于是自动创建一个最简单的默认配置文件,并自动扫描目录下的 md 文件添加到当前配置文件中;自动创建默认主页教用户最简单的配置文件应该怎么写。
    arobota
    arobota
    OP
    May 24, 2020
    3
    arobota
    arobota
    OP
    May 24, 2020
    4
    @whileFalse 另外那个站只是记录文档,这个才是主页
    https://www.leosirius.com/
    whileFalse
    whileFalse
    May 24, 2020
    5
    @arobota #3 我看到这个文件了,然而 repo 根目录下这个 yml 应该是以展示所有功能为目的编写的,过于复杂,无法在短时间内理解并套用。
    LuckyDee
    LuckyDee
    May 24, 2020
    6
    话说老哥你刷了多久刷完的
    fakepoet
    fakepoet
    May 24, 2020
    7
    @arobota 主页也不好看啊。。。
    arobota
    arobota
    OP
    May 24, 2020
    8
    @LuckyDee 并没刷完。。。
    lscexpress
    lscexpress
    May 24, 2020
    9
    他们都说你主页丑,审美不一样,别在意。

    但你的网站是真的慢,即使 304 的情况下,依旧达到了 800ms 。
    tubimasky
    tubimasky
    May 24, 2020
    10
    win 下用客户端或者命令行都检出失败
    Clone succeeded, but checkout failed.
    linux 下无问题 是个例吗
    Cloning into 'leetcode_solutions'...
    remote: Enumerating objects: 141, done.
    remote: Counting objects: 100% (141/141), done.
    remote: Compressing objects: 100% (114/114), done.

    Receiving objects: 100% (5195/5195), 13.07 MiB | 174.00 KiB/s, done.
    Resolving deltas: 100% (2321/2321), done.
    error: unable to create file 0057_Insert_Interval /Solution1.cpp: No such file or directory
    error: unable to create file 0057_Insert_Interval /slt.md: No such file or directory
    error: unable to create file 0097_Interleaving_String /Solution1.cpp: No such file or directory
    error: unable to create file 0097_Interleaving_String /slt.md: No such file or directory
    fatal: cannot create directory at '0597_Friend_Requests_I:_Overall_Acceptance_Rate': Invalid argument
    warning: Clone succeeded, but checkout failed.
    You can inspect what was checked out with 'git status'
    and retry with 'git restore --source=HEAD :/'
    MarkLeeyun
    MarkLeeyun
    May 24, 2020
    11
    啊哈哈哈哈,难以上手而且慢。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   2992 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 51ms · UTC 11:32 · PVG 19:32 · LAX 03:32 · JFK 06:32
    ♥ Do have faith in what you're doing.