GithubHelp home page GithubHelp logo

Comments (6)

waruqi avatar waruqi commented on August 22, 2024

有一些生成文件混进来了

主页面生成是执行landing/build脚本生成的,可能是会有一些其他文件

不同语言的目录层级不同,英语在根目录下,汉语却在 zh cn 两个文件夹

cn是里面docute文档里面路径结构,而zh是主页面的结构,用的是两个不同的框架 所以会这样

单个文件太长,编辑困难,能否分成多个文件,在生成 html 时再进行合并

这个暂时没办法,目前用的docute直接渲染的md文档,但是md的分割不支持,这个问题也困扰我很久了,除非换其他文档框架,比如vuepress,这就改动大了,还要修复文档里面的link,所以暂时先这么凑活着用了

from xmake-docs.

OpportunityLiu avatar OpportunityLiu commented on August 22, 2024

还是人太少了,我看vscode的插件也好久没更新了,add_cuflags都不提示的

from xmake-docs.

waruqi avatar waruqi commented on August 22, 2024

嗯 现在就我一个人维护 个人时间也不是很多 所以有些更新慢了些 vscode这个 我之前改了些 不过提交发布的时候 遇到点问题 token认证过期失效后 重新生成了 提交一直失败 后来一直没时间去折腾

等回头我再看看

from xmake-docs.

waruqi avatar waruqi commented on August 22, 2024

vscode 的 publish 我刚重新研究了下,现在可以重新提交上去了,你可以改进下completion.ts里的提示列表,来更新下缺失的关键字 回头我会发个新版本 https://github.com/xmake-io/xmake-vscode/blob/master/src/completion.ts

from xmake-docs.

waruqi avatar waruqi commented on August 22, 2024

之前有想过切到vuepress,其他都还不错,就是目录分层只能限制4层,不满足这边需求

最近看着mkdocs还不错,回头有时间研究下,如果完全满足这边需求,可以尝试下 切换到这个上 去 拆分md

from xmake-docs.

waruqi avatar waruqi commented on August 22, 2024

文档我整个替换成 docsify 框架了,所有md文档都做了拆分,尤其是manual.md,都在manual目录下

并且对外原先输出的links,我基本上都做了兼容处理,里面old目录里面放置的都是原有的老的单页文档,仅仅只是为了兼容现有links才保留的,不再做更新。

不过内部api跳转links,manual.md之前是单页面,现在拆分成多页面后,某些跨页面的 api 跳转links,我还没修复,不过这部分量不大,回头我抽空再一点点修复。。

from xmake-docs.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.