Visual Studio的无缝内使用docfx。 注:官方docfx.msbuild的NuGet包现在在预发布版本。您也可以使用源代码编译,并在本地使用它。...我们支持Docfx Flavored Markdown(DFM) 编写的文档。 ...DFM是Github上 Markdown(GFM),并增加了一些新的功能,包括文件包含 , 交叉引用 ,和YAML头 100%兼容 。...在docfx中,最重要的就是生成文档,把markdown文件(gfm语法)转换成html,微软还开源一个基于gfm的并且很容易扩展的语法的markdown组件 MarkdownLite,代码包含在docfx...A: 是的,可以参考文档 Q: docfx跨平台么? A: docfx支持在dnx下运行。
首先在当前目录下创建 .vuepress 目录(所有 VuePress 相关的文件都放在此目录下),然后在 .vuepress 目录下创建 config.js 文件(也可以使用YAML (.vuepress...description: '顾斯比的博客', // 网站的描述,它将会以 标签渲染到当前页面的 HTML 中。...安装 yarn add @vuepress/theme-blog -D # OR npm install @vuepress/theme-blog -D 使用&配置 在config.js 中添加主题相关配置...并且必须采用在三点划线之间书写的有效的 YAML。...frontmatter 中设置 search 来对单独的页面禁用内置的搜索框: --- search: false --- 「⚠️提示」 「内置搜索只会为页面的标题、****h2」 「、」 「h3」
front-matter/注意的是采用三虚线必须放置在 markdown 文件的 最上面---title: Blogging Like a Hackerlang: en-US---frontmatter... {{ $frontmatter.date }}任何包含 YAML frontmatter 块的 Markdown 文件都将被 gray matter 处理。...frontmatter 必须位于 Markdown 文件的顶部,而且必须采用三条虚线之间的有效 YAML 集的形式。...这些变量能够经过$frontmatter 变量来使用。...docs/.vitepress/theme/index.ts 中写入如下代码,其中 register-components.js 不需要自己创建,在 package.json 中注入脚本,执行脚本自动生成在
==" crossorigin="anonymous" referrerpolicy="no-referrer"> 浏览器中,直接使用 window 对象访问 let md =...在 VuePress 中,目前自带了一个默认的主题(正是你现在所看到的),它是为技术文档而设计的。...YAML:是一种表达数据序列化的格式。 Front matter:直译为“前置内容”,它是基于 YAML 格式的纯文本内容,放置在文档开头,用于标明文档的各种属性(元信息)。...}}的个人技术博客站点** home: true 启用主题 将 heroText、tagline 的内容设置为 null 来禁用标题和副标题 定义变量 author,文档中可以通过 {{ $frontmatter.xx...}} 方式获取 设置 footer 导航栏 在 .vuepress/config.js 配置文件中,通过 themeConfig.nav 增加一些导航栏链接: // .vuepress/config.js
对于这个特定的博客文章,我们想要一个单页面应用的感觉(没有页面重载),以及在 head 标签中动态更改 title标签的能力。...变压器插件 正如前面提到的,transformer插件采用了一些底层的数据格式,这种格式在当前的表单中是不可用的(Markdown,json,yaml等),我们可以用GraphQL查询把它转换成 Gatsby...当然,我们的数据结构是在我们的Markdown文件开始时提供的 frontmatter。我们定义的每个键都可以被注入到查询中。...我们将使用这些数据来构建一个包含盖茨比的页面。我们的 GraphQL“形状”直接反映在这个数据对象中,因此,当我们在GraphQL博客文章模板中查询时,我们从该查询中提取的每个属性都将可用。...现在我们有一个由 Gatsby 所生成的功能完整的博客,其中有真正的内容在 Markdown 里,有一个博客列表,以及在博客中浏览的能力。
使用 VuePress 工具,我们可以在 head 配置中添加网站 head 标签信息,比如设置站点图标、设置有利于 SEO(搜索引擎优化)的元信息、添加第三方统计分析代码等:head: [ // 站点图标...配置VuePress 的基本功能就是把我们写的 Markdown 文件渲染成网站,我们可以在 markdown 配置中自定义网站的渲染规则,比如显示代码块的行号、支持更细层级的标题渲染等:markdown...然后在 config.ts 中引用。...,比如把文章描述、标签信息放到标签中,从而增加收录率。...的 FrontMatter 语法定义标签,然后在网站上展示。
markdown 中混合使用 Vue 组件,编译器会帮你处理静态/动态分离工作 4.使用了 Vite 5.更快的 dev 服务器启动 6.更快的热更新 7.更快的构建(使用 Rollup) 更轻量的页面...扩展 标题锚点 标题自动会产生锚点 锚点渲染可以通过 markdown.anchor 选项设置 链接 内部链接 每个子目录里的 index.md 会自动转换为 index.html, 并且访问路径是...-- 指向在 foo 目录的 README 文件中的某个标题 --> [bar - three](../bar/three) [bar - three](.....YAML frontmatter title: Blogging Like a Hacker lang: en-US GitHub-样式 表格 输入 Tables Are Cool col 3 is...可以通过在 .vitepress/config.js 中使用 markdown 选项定制: module.exports = { markdown: { // options for markdown-it-anchor
像组件一样,第一步是将布局导入到代码栅栏,然后通过在模板部分放置其标签来使用它。下面就是index.astro的样子: --- import BaseLayout from '.....在我们的例子中,我们可以定义一个pageTitle参数,并把它传递给我们的BaseLayout组件,以便能够在不同的页面上有不同的页面标题。...在本教程中,我们坚持使用标准的Markdown内容。 在我们进一步讨论之前,有必要提到Astro v2引入了内容集合[6],这是一种在Astro项目中组织内容的绝佳方式。...另外,注意到我们是如何将我们页面的标题传递给BaseLayout中的页面标题的: 让我们给BlogLayout添加一些样式...添加脚本 你可以使用标准的HTML 标签向你的Astro组件添加交互。这允许你发送JavaScript到浏览器中运行,并为你的Astro组件添加功能。
在 Endnote 中同样有类似的引用方式,这个概念被称作 Temporary citation。...在 Word 插件中的 Zotero 的引用效果如下图所示。 ? 类似的效果只有同时在我们使用的编辑器中实现,才能做到 CITE AS YOU WRITE。...自动操作 如果你在使用 macOS,或许还不知道它也有类似于 iOS 中快捷指令的功能,叫做 Automator(自动操作)。...我们可以在 Markdown 文本中写入相关元数据,或者在 pandoc 命令行中进行相关参数设置。...此外,因为 workflow 插入的格式为 @adams2001 而 Pandoc 转化时在 Markdown 中识别的格式为 [@adams2001],所以有了另一个小需求:快速输入 []并且把光标置于两个括号间
Vuepress框架-文章打包发布到WordPress 一、目的 放弃使用Vuepress框架,后续使用WordPress进行文章记录,Vuepress原有的文章需要迁移到WordPress中...安装依赖项 pip3 install python-frontmatter pip3 install markdown pip3 install python-wordpress-xmlrpc 四、调整脚本配置内容...批量上传Markdown文件到WordPress 打开upload-markdown-to-wordpress.py,在主函数中修改以下四行: path = 'your directory path or...用pycharm打开update-markdown-to-wordpress.py,在主函数中修改以下四行: filepath = 'your directory path or file path which...注意:本地Markdown文件名和WordPress文章的标题需要保持一致。 代码修改完毕后,最后运行update-markdown-to-wordpress.py,即可实现更新内容
[摘要] 这是我编写的一个 Docfx 文档自动生成工具,只要写好 Markdown 文档,使用此工具可为目录、文件快速生成配置,然后直接使用 docfx 运行即可。...然后 ↓ 新建一个目录,用来存放 markdown 文件。打开目录,按住 Shift + 鼠标右键 ,打开 Powershell 。...两个命令 docfx init -q docfx docfx_project\docfx.json --serve // 以实际路径为准 二, 创建 Docfx 项目 使用此命令在目录下初始一个...文字文档 文字文档使用 markdown 文件编写,存放位置 articles 。...docfx_project\docfx.json --serve 使用 CZGL.DocfxBuild.Yml 可以帮助你快速生成文档目录。
这个文件的开始是YAML元数据部分, 进行全书的有关设置,包括标题、作者、日期及影响全书的一些选项等,放在三个减号组成的两行之间。然后写一些这本书的说明,如书的前言部分。...每一章可以有若干节与子节,分别用markdown的二级标题(二个#开始)和三级标题(三个#开始)编写。...bookdown的章、节、子节标题单独成一行,其后可以添加标签, 章节的标签是标题后加空格,然后是大括号内以#号开头的标签, 如 # 引言 {#intro} ## 关于bookdown {#bookdown...为此,在一个部分的第一个章节文件的章标题前面增加一行, 以# (PART) 开头, 以{-}结尾,例如 # (PART) bookdown中的浮动对象 {-} 2....(prefix); 文本标签在单独一行中设定,可用在表格与图形的caption中引用,即在 fig.caption, tab.caption选项的设置中引用; 定理类环境标签前缀的汉化可在_bookdown.yml
、代码块 等 但是实际使用中,试了好几款翻译(包括 Google,DeepL,Azure), 结果发现效果都不理想....为什么要翻译 Markdown 文件 为什么要翻译 Markdown 文件?翻译 HTML 文件不行吗? 这是因为现在越来越多的工具使用 Markdown 来组织他们的内容。...将 Markdown 拆分为"段" 1.将文件分解成"段"。2.获得一对句子和一个块的信息。例如,该块是一个标题、一个段落、一个代码块还是其他。...3.如果该"段"不是代码块或Frontmatter,则将该文本发送到翻译的API。4.用收到的句子覆盖该块中的句子。5.以 Markdown 格式再次构建。6.保存为新的文件名。...但是在翻译的过程中, 却面临一系列的困难, 如: •Markdown 语法被损坏•翻译一些不应该被翻译的内容, 如:•翻译结果中出现了不同的 Markdown flavor 并以此提出翻译 Markdown
两个分隔符之间的文本是 YAML 格式的数据对象。...#3.内联样式 你可以在 Markdown 中直接使用 标签来覆盖当前幻灯片的样式。...它们将展示在 演讲者模式 中,供你在演示时参考。 在 Markdown 中,每张幻灯片中的最后一个注释块将被视为备注。...#10.图表 你也可以在 Markdown 的文本描述中创建图形或图表,得益于 Mermaid。...你可以为主入口点和外部 markdown 页面提供 frontmatter。
最近使用 DocFX 对 Rafy 框架的帮助文档进行了升级。...其使用的就是最新的文档编写、生成工具:DocFX。DocFX 的网址:http://dotnet.github.io/docfx/。...使用帮助,可以看看这篇:《docfx 做一个和微软一样的文档平台》 简单地说,docFX 支持使用 markdown 来编写文档。并最终生成对应的网站。 Markdown 是一个简单标记语言。...目前大多数的文档编写都流行使用这个语言。例如 Github 中每个项目的 Wiki 都是使用 markdown 来编写。...直接使用 markdown 就可以快速编写了。然后使用 DocFX 一键生成 WebSite,直接上传到 Github Pages 就行了。
img标签都加上alt 17 高阶技巧:使用JSON-ld结构化数据 18 SEO得分: 97 真不是沪小羊吹啊,Google给沪小羊的vuepress网站的SEO水平打97分。...具体操作,就是在markdown的frontmatter中把 permanentlink 设置成相对路径即可。...meta优化 使用插件 webmasterish/vuepress-plugin-autometa 可以自动生成meta标签及其内容,包括 meta keywords, meta description...安装方法: npm install -D vuepress-plugin-feed 需要注意的是: _posts文件夹以外地方的markdown文件,都需要加上下面的配置才能确保出现在 rss.xml中...' } , 而我们需要加上nofollow,修改config.js中对应的选项 markdown -> externalLinks 即可,这里只需在合适的地方加上nofollow,如下图~ image.png
npm run docs:dev~~~~ 我们已经创建了我们的网站,在浏览器中打开 http://localhost:3000,则会在网页中看到我们的markdown文件! ?...Vitepress 创建 SPA 导航时,它将使用每个markdown文件的路径来创建路由。 此外,任何文件夹中名为index.md的文件也只能由/引用。...在Vitepress中内置元素 Vitepress 附带了对几个元素的支持,我们可以在config.js中或在Markdown中直接声明这些元素。...Markdown Frontmatter配置 尽管我们可以使用./vuepress/config.js配置网站,但有时我们还是需要对各个页面进行更细的控制。...幸运的是,我们可以使用markdown文件顶部的YAML块来控制每个页面。 Vitepress通过用三个虚线(---)包围它来声明该块。
Liquid[3] 模板引擎在使用上有诸多不便。...在 Gatsby 中,根据 js 文件的位置不同,使用 GraphQL 有两种形式,且 Gatsby 对其做了魔法,在 src/pages 下的页面可以直接 export GraphQL 查询,在其它页面需要用...一般使用时只需要知道集合里每个项目的数据在 edges.node 中,同时通过 GraphiQL 浏览其它可以使用的数据。...修改 Markdown 节点 在 Remark 插件生成的 Markdown 节点中,我们可以往 fields 域放一些自定义的变量。这里我们把自定义的路径存到 fields.slug 中。...首先是普通的文章页面生成,这个是在 createPages 钩子中,如果你的博客只有文章用到 Markdown 的话,可以在 GraphQL 查询中直接过滤,否则我们用前面文章的方法,先取所有 Markdown
高性能 在许多 Web框架 中,在开发过程中很容易构建一个看起来很棒的网站,但是在部署后加载速度会非常慢。...Astro 将实时监听 src 目录文件的更改,因此你在开发过程中进行更改时无需重新启动服务器。...路由 Astro 的路由基于文件,它根据项目的 src/pages 目录中的文件结构来生成你的构建链接。当一个文件被添加到 src/pages 目录中,它将自动基于文件名生成与之对应的路由。...使用变量 frontmatter 变量可以直接在 Markdown 中用 frontmatter 对象属性使用。...文件中!
#1797 @guqing 优化 Markdown 文档导入的 FrontMatter 的解析规则。 #1813 @LIlGG 优化文章和分类的加密逻辑。...#1824 @guqing 修复后台仪表盘统计中图标显示不完整的问题。...halo-dev/halo-admin#539 @ruibaby 修复后台文章回收站列表文章标题无法显示完整的问题。...开启缓存的方式很简单:访问.halo文件夹,打开 application.yaml文件进行编辑就可以了 在该文件的halo里面,配置cache:level 就可以了。...然后使用Linux 的systemd 进行控制Halo的启动了: service halo start 然后等待一会,我们就可以在浏览器中正常访问博客了。 到这里就更新完毕了。 4.
领取专属 10元无门槛券
手把手带您无忧上云