TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

VuePress: a static site generator that excels at working with documentation

188 点作者 dwalkr将近 7 年前

9 条评论

segphault将近 7 年前
VuePress pulls in nearly a thousand transitive dependencies. In light of recent security incidents[0][1] and the relative ubiquity of poor security practices[2] in the npm ecosystem, that seems like an unacceptably large attack surface.<p>I don&#x27;t want to have to worry about somebody injecting malicious code or cryptocurrency miners into my website by compromising a little-watched transitive dependency in my static site generator.<p>[0] <a href="https:&#x2F;&#x2F;blog.npmjs.org&#x2F;post&#x2F;175824896885&#x2F;incident-report-npm-inc-operations-incident-of" rel="nofollow">https:&#x2F;&#x2F;blog.npmjs.org&#x2F;post&#x2F;175824896885&#x2F;incident-report-npm...</a> [1] <a href="https:&#x2F;&#x2F;blog.npmjs.org&#x2F;post&#x2F;173526807575&#x2F;reported-malicious-module-getcookies" rel="nofollow">https:&#x2F;&#x2F;blog.npmjs.org&#x2F;post&#x2F;173526807575&#x2F;reported-malicious-...</a> [2] <a href="https:&#x2F;&#x2F;www.bleepingcomputer.com&#x2F;news&#x2F;security&#x2F;52-percent-of-all-javascript-npm-packages-could-have-been-hacked-via-weak-credentials&#x2F;" rel="nofollow">https:&#x2F;&#x2F;www.bleepingcomputer.com&#x2F;news&#x2F;security&#x2F;52-percent-of...</a>
评论 #17738957 未加载
评论 #17737590 未加载
mintplant将近 7 年前
I&#x27;m using VuePress to auto-generate a static, non-interactive site from a set of Vue components and some input data that&#x27;s updated daily. For me it serves the purpose of a batteries-included way to render Vue to HTML, without messing with SSR libraries, webpack, or Babel configurations myself. I find Vue&#x27;s composability a much tidier way of doing things than the file-inclusion-based setups typical of systems designed for static site generation.<p>That said, I&#x27;ve had to write a Python script to do some pre- and post-processing on the VuePress files. Generating a single README.md whose front matter contains my input JSON; stripping out script tags, as there&#x27;s currently no way to prevent VuePress from generating them in the first place; minifying the HTML; injecting some extra tags; moving files around. There&#x27;s a bit of a mismatch here between my use case and VuePress&#x27;s primary role as a documentation generator.<p>I&#x27;d love to be able to call into VuePress as a library, instead of running it as a separate executable, and, for example, pass it my input data directly instead of writing it out to a temporary file for it to read back in. This is something I plan to toy with implementing once I get some free time again (currently bogged down with preparing to give a talk).
ncphillips将近 7 年前
I said it before and I&#x27;ll say it again: VuePress is impressively easy to get started with. Running `vuepress dev` in an empty directory is all you need to get started.<p>Also, I really love the decision to make `README.md` files act as the `index.html` files. This has the benefit of making your docs easy to read from your projects Github repo.<p>Looking forward to seeing how it progresses.
评论 #17736359 未加载
ridiculous_fish将近 7 年前
Is this in the same space as Sphinx and Doxygen? The VuePress docs only have a trivial markdown example.
评论 #17738941 未加载
zhs将近 7 年前
How does it compare to docusaurus, gitdocs, and a variety of other tools out there?
评论 #17736222 未加载
RyanShook将近 7 年前
I guess there’s no such thing as too many static site generators...
评论 #17737958 未加载
_Chief将近 7 年前
vuepress also generates SEO friendly docs, eg when compared to docsify, but on the flip side docsify has full text search, while the default vuepress theme only searches headers (but since its seo ready most third party search will work ef algolia, google).
wolco将近 7 年前
I&#x27;m enjoying the weekend vue articles that have appeared lately.
superkuh将近 7 年前
All these static site &quot;generators&quot; seem pretty silly. If you&#x27;re going to make a static site then just make a few template pages by hand in html then copy and edit them to fill with whatever content.<p>It works even better if your webserver has server side includes (SSI) turned on. Then you can make header&#x2F;footer&#x2F;sidebar&#x2F;etc templates and just insert them with a line in the page templates.
评论 #17737346 未加载
评论 #17737253 未加载
评论 #17737865 未加载
评论 #17737288 未加载
评论 #17737804 未加载
评论 #17737050 未加载