MkDocs是一个快速,简单且彻头彻尾的华丽静态站点生成器,旨在构建项目文档。文档源文件以Markdown编写,并使用单个YAML配置文件进行配置。
先放官网链接:https://github.com/dongyuanxin/vuepress-plugin-comment
Gatsby 是一个令人难以置信的静态站点生成器,它允许使用React作为渲染引擎引擎来搭建一个静态站点,它真正具有现代web应用程序所期望的所有优点。它通过在构建时通过服务器端渲染将动态的 react 组件呈现为静态 HTML 内容。这意味着您的用户可以获得静态站点的所有好处,比如不使用JavaScript、搜索引擎友好性、非常快的加载速度等等,也并没有失去现代web所期望的活力和交互性。一旦呈现为静态 HTML,客户端站点的React和JavaScript会接管它并添加动态的内容。 Gatsby 最近发布了v1.0.0,推出了很多新特性。包括(但不限于)使用GraphQL创建内容查询的能力,与各种cms集成——包括WordPress、Contentful、Drupal等等。还有基于路由的代码分布使得用户体验更佳。在这篇文章中,我们将深入探讨 Gatsby 和一些新特性,并创建一个静态博客。让我们开始吧!
对于 report 和 book 文档类,结构类似,但它们提供了更多的章节级别,例如 \chapter 用于书籍中的章节。以下是一个使用 book 文档类的示例:
MkDocs---markdown项目文档工具,是一个用来创建项目文档的快速、简单、完美的静态站点生成器,文档源码使用Markdown来撰写,用一个yml文件作为配置文档。它具有如下几个优点:
对于程序员来说,写技术文档是一项必备的技能。由于GitHub和Markdown格式的普及,很多时候我们可以用markdown来简便地写出技术文档,并且 通过GitHub Pages等工具快速地进行技术文档的部署。
通过文档介绍这些信息,新读者才能更直观地了解产品,决定是否要用它,而产品的用户则能更顺利地使用它。
1.查数据 { allMarkdownRemark(sort: {order: DESC, fields: [frontmatter___date]}) { edges { node { frontmatter { title path date excerpt } } } } } 如图所示: 1557047446713.png 2.套页面 打开in
在这个实用的Astro指南中,我将指导你完成设置过程,并告诉你如何构造你的文件。你将学习如何添加页面、交互式组件,甚至是markdown文章。我还会告诉你如何从服务器上获取数据,创建布局,并使用vanilla JavaScript和其他框架添加互动性。准备好享受一些动手的乐趣,因为我们将一起创建一个小型的网站实例。我们将构建一个多页面的网站,包括一个博客。
10个优秀的程序员里,有9个人都有写博客的习惯。这是非常好的习惯,它使得知识得以提炼,转输出为输入,在提升自己的同时,还能利用互联网易传播的特性,将知识分享给每一个热爱学习的人。这是值得每个程序员,投入时间和精力去坚持做下去的事。
我的博客最初是用 Github Pages 默认的 Jekyll[2] 框架,其使用的 Liquid[3] 模板引擎在使用上有诸多不便。
Mkdocs 是我比较喜欢的文档系统,用于部署知识库是非常合适的,特别是Mkdocs+material组合更是我最为喜欢的。 目前唯一的缺点就是中文搜索方面不足,所有需要手动修改一下,当然如果您和我一样基于Docker部署,那么也可以修改一次到处运行。
注意,这里跟前面不一样了,我用gatsby-node.js这个文件去提供数据,没有什么为什么,规定,照做就好。
真不是沪小羊吹啊,Google给沪小羊的vuepress网站的SEO水平打97分。
VitePress 是 VuePress 的小弟弟,但是vitepress是在 Vite 上构建的。
这些开源项目旨在为用户提供一种简单而强大的方式来构建现代化文档或静态网站。它们拥有一些关键特性:简洁易用、支持使用Markdown编写内容、提供多种主题选择和插件扩展能力。这些工具可以帮助您方便快捷地生成高质量的文档,并且轻松进行团队协作和社区分享。如果您正在寻找一个功能强大又易于上手的工具来构建静态网站或在线文档,请考虑尝试其中之一。
Microsoft PowerToys 是一套用于调整和优化 Windows 体验以提高生产力的实用工具集。该项目包含多个功能模块,其中主要功能有:Always on Top、FancyZones、File Explorer Add-ons 等。其核心优势和关键特点包括:
VitePress 是 VuePress 的下一代框架 ,是支持vue 3.0 的 web 网站框架。
最近啊,我比较迷恋文档和静态站点生成,今天我们再分享一个基于 Python 和 Markdown 的文档生成器。它就是 MkDocs。
大家好,我是保姆皮,最近我上线了自己的《编程宝典》网站,可以在线阅读我分享过的各种编程学习路线和知识干货。
1.查数据 <pre class="md-fences md-end-block" lang="" contenteditable="false" cid="c8" mdtype="fences" style="box-sizing: border-box; overflow: visible; font-family: Consolas, 'Liberation Mono', Courier, monospace; font-size: 0.9em; white-space: pre; display:
到此,通过gatsby就快速的搭建了一个博客网站,我们只需书写markdown文件就能生成对应的网页了。至于网页美化,那是切图的事儿,我就不在这里墨迹了。
Mkdocs 是一个采用 Python 构建轻量级的静态 HTML 在线文档框架,内置部署到 Github Pages 的功能。我用来创建实践指南,用来做个人的知识积累。
同博客框架 WordPress、Hexo 等一样,Web 文档也有自己的框架,如比如 Java 的 Javadoc,Python 的 pydoc,以及Python-sphinx。对于 Python 有专门文档标记语言 reStructuredText(RST),常见的 Python 各种库和工具的帮助文档基本都是用 RST 所写。如 Requests、Flask、Scrapy 等。
不排除很多小伙伴,从小认识电脑,就开始装office全家桶。有什么重要的小笔记,小心心地写在小本本上,用了电脑,写一个word存档。
VuePress 是一个静态网站生成器,包含由Vue驱动的主题系统和插件API,同时还包含一个为书写技术文档而优化的默认主题。此篇文章只介绍如何使用VuePress 搭建个人博客的部分。
本文将介绍最流行的十大博客静态站点生成工具,以 Github star 数来排名。
参考 https://github.com/rmcfadzean/gatsby-pantry/tree/master/examples/starter-blog
GiantPandaCV 一直是以公众号的形式和大家见面,但现在随着分享干货的日益增多,我们不满足于公众号小小的窗口,为了方便大家快速检索自己感兴趣的知识,也为了增加和大家的交流, GiantPandaCV.COM 应运而生,拉到底部点击 阅读原文 即可访问,或者复制网址到浏览器访问。
前面我们介绍过 Pelican、MkDocs 等流行的静态展点生成器,今天我们再次介绍一个比较冷门的静态站点生成库,它就是 Nikola。
但是每次都要输入路径就比较繁琐,这里推荐将命令直接写入 package.json,然后用 npm run 来执行。 例如:
前面我们介绍过 MKDocs 的基础用法(MKDocs 入门)。很多同学都表示非常香,但是默认的主题不够美观,虽然我们可以通过内置的 readthedocs 主题来改善,但是还不够美,几天我们就一起来尝试一款比较现代的 MKDocs 主题 material。
mkdocs 是一个基于Python 对 Markdown 非常友好的文档生成器,中文文档地址
StaticImage 是 gatsby-plugin-image 提供的组件,类似html 中的 img 标签,可以在页面中直接使用。
如果你问10个互不相干的程序员,问他们最青睐的2种编程语言是啥,我想Python会有极大的概率出现在里面,这充分说明了其在编码圈不可撼动的江湖地位,Python是一门老牌而有非常具有活力的编程语言,发展这么久,讲真不用github都知道,肯定有非常多的web框架了,我们今天的主题是使用Python来搭建一个个人主页,如果使用Python已有的web框架,应该是非常简单的事情。但是本文的目标是自己使用Python实现一个自己的web框架,当然是一个基础版的,在实现之前,我们先了解下主流的web框架是怎么玩的。
文章更新时间,本地和远程部署的不同,远程通过github action|vecel部署,远程部署后的时间不对,会把所有文章时间都更为最新。
当时我学习Deep Learning已有两个月,看了很多论文、教程与博客,于是尝试着去阅读Keras的源代码来学习别人是怎么实现的,尤其是back propagation这一块。
新冠肺炎期间,约翰霍普金斯大学开发的疫情地图网站单日 PV 达 10 亿次,查看源代码可以看出它是一个单页应用(single-page application,缩写 SPA),JS 调用后端 API 返回动态数据。
相信很多人都想要搭建一个自己的博客或是给项目做文档网站。本文将要推荐的静态网站生成器(Static Site Generator, SSG),它做的事情就是把你的文档、内容(通常为 Markdown 文件)生成可发布成网站(html)的工具,这样你就可以专心创作,同时也有了一块自己发表自己想法的网站。然后 GitHub、Gitee 等均支持免费 Page 服务,通过简单的配置 SSG 就可以实现一条命令发布,有一个自己小窝就是这么简单和方便~
拥有自己的技术博客,不仅可以提升自己的技术能力,还可以提升自己的影响力,未来也可能带来一些“睡后”收益。
支撑10亿PV的云存储 新冠肺炎期间,约翰霍普金斯大学开发的疫情地图网站单日PV达10亿次,查看源代码可以看出它是一个单页应用(single-page application,缩写SPA),JS调用后端API返回动态数据。那么,部署一个10亿PV的静态网站需要购买几台服务器呢? 答案是:0台! 在云计算时代,静态网站已不再需要服务器,部署到云存储,开启CDN即可全球高速访问。 静态网站架构发展史 1991年,万维网诞生,包括3项关键技术: 统一资源标志符(URI)、HTML、HTTP。
Astro 是集多功能于一体的 Web 框架,用于构建快速、以内容为中心的网站,可集成Vue、React、Tailwind、Svelte等多种前端框架,可快速构建个人博客、文档网站和公司官网等内容网站
VitePress 是一个静态站点生成器 (SSG),专为构建快速、以内容为中心的网站而设计。简而言之,VitePress 获取用 Markdown 编写的源内容,为其应用主题,并生成可以轻松部署在任何地方的静态 HTML 页面。
写博客多年,除了 EmacsTalk[3] 这个网站,我还有个 Keep Coding[4] 的个人博客。写博客的好处这里不想多说,可以参考这篇文章:
领取专属 10元无门槛券
手把手带您无忧上云