From b87d32419f93973b1184278ea51a12c33dc2d673 Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Wed, 7 Jun 2023 00:08:36 +0800 Subject: [PATCH] RP @chai001125 https://linux.cn/article-15884-1.html --- ...erate web pages from Markdown with Docsify-This.md | 35 +++++++++++-------- 1 file changed, 20 insertions(+), 15 deletions(-) rename {translated/tech => published}/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md (74%) diff --git a/translated/tech/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md b/published/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md similarity index 74% rename from translated/tech/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md rename to published/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md index 71f9a5d0d1..44a2d956c1 100644 --- a/translated/tech/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md +++ b/published/20230502.2 ⭐️⭐️ Generate web pages from Markdown with Docsify-This.md @@ -3,26 +3,28 @@ [#]: author: "Paul Hibbitts https://opensource.com/users/paulhibbitts" [#]: collector: "lkxed" [#]: translator: "chai001125" -[#]: reviewer: " " -[#]: publisher: " " -[#]: url: " " +[#]: reviewer: "wxy" +[#]: publisher: "wxy" +[#]: url: "https://linux.cn/article-15884-1.html" 使用 Docsify-This 从 Markdown 文件生成网页 ====== -将 Markdown 文件直接变成网页，还无需任何的网站构建，写完文档即可直接发布，你对这个内容感兴趣吗？你是否希望将 Markdown 或 HTML 自由地嵌入到多个平台（如内容管理系统或学习管理系统）中？由 [Docsify.js][2] 构建的开源项目 [Docsify-This][1] 提供了一种简单的方法来发布、分享和复用 Markdown 文件内容。 +![][0] -**你可以点击这个链接，来看看 [Markdown 语法速查表][3]** +> 这个开源工具可以轻松将 Markdown 转换为网页。 + +将 Markdown 文件直接变成网页，还无需搭建网站和生成过程，写完文档即可直接发布，你对这个内容感兴趣吗？你是否希望将 Markdown 或 HTML 自由地嵌入到多个平台（如内容管理系统或学习管理系统）中？由 [Docsify.js][2] 构建的开源项目 [Docsify-This][1] 提供了一种简单的方法来发布、分享和复用 Markdown 文件内容。 ### Docsify-This 是什么？ -使用 Docsify-This，你可以立即将任何 Markdown 文件转换为响应式的独立网页。你还可以将多个 Markdown 文件链接起来，以创建一个简单的网站。网页设计师可以简单地通过点击 Web 页面构建器界面或改变网页的地址参数（即 URL），来更改所显示页面的视觉外观。在创建自己的 Markdown 文件内容时，你还可以使用 Markdown CSS 类。此外，如果你使用 Codeberg 或 GitHub 仓库存储 Markdown 文件的话，每个页面都会自动提供一个 **编辑此页面** Edit this Page 的链接，以支持协同创作。 +使用 Docsify-This，你可以立即将任何 Markdown 文件转换为响应式的独立网页。你还可以将多个 Markdown 文件链接起来，以创建一个简单的网站。网页设计师可以简单地通过点击 Web 页面生成器界面或改变网页的地址参数（即 URL），来更改所显示页面的视觉外观。在创建自己的 Markdown 文件内容时，你还可以使用一组提供的 Markdown CSS 类。此外，如果你使用 Codeberg 或 GitHub 仓库存储 Markdown 文件的话，每个页面都会自动提供一个 “编辑此页面Edit this Page” 的链接，以支持协同创作。 -并且 Docsify-This 是开源的，因此你可以使用自定义域名托管 Docsify-This 实例，而不会有平台锁定域名的风险。 +并且 Docsify-This 是开源的，因此你可以使用自定义域名托管 Docsify-This 实例，而不会有被平台锁定的风险。 -### 使用 Docsify-This 网页构建器 +### 使用 Docsify-This 网页生成器 -要使用网页构建器，请先打开浏览器，导航到 [Docsify-This网站][1] 或你在本地的实例。在 **网页构建器** Web Page Builder 部分，输入 Codeberg 或 GitHub 上公共存储仓库中的一个 Markdown 文件的 URL（其他 Git 主机可以通过 Docsify-This URL 参数进行使用，但不能在网页构建器中使用），然后点击 **发布为独立网页** Publish as Standalone Web Page 的按钮，如下图所示。 +要使用网页生成器，请先打开浏览器，导航到 [Docsify-This 网站][1] 或你在本地的实例。在 “网页生成器Web Page Builder” 部分，输入 Codeberg 或 GitHub 上公共存储仓库中的一个 Markdown 文件的 URL（其他 Git 主机可以通过 Docsify-This URL 参数进行使用，但不能在网页生成器中使用），然后点击 “发布为独立网页Publish as Standalone Web Page” 的按钮，如下图所示。 ![The Docsify-This web page builder interface][4] @@ -38,7 +40,7 @@ Docsify-This 生成的网页非常适合嵌入，可以将 Docsify-This 页面 ### 渲染同一存储库中的其他文件 -你也可以通过直接编辑 Docsify-This URL 参数 **homepage** 来渲染同一存储库中的其他 Markdown 文件。例如： +你也可以通过直接编辑 Docsify-This URL 参数 `homepage` 来渲染同一存储库中的其他 Markdown 文件。例如： ``` https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-this-one-page-article/main&homepage=anotherfile.md @@ -52,7 +54,7 @@ https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-de https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-this-one-page-article/main&homepage=home.md&font-family=Open%20Sans,sans-serif ``` -你也可以使用一组特殊的 [Markdown CSS 类][7] 来改变网页的外观。例如，你可以为一个链接添加 `按钮类`： +你也可以使用一组特殊的 [Markdown CSS 类][7] 来改变网页的外观。例如，你可以为一个链接添加“按钮类”： ``` [Required Reading Quiz due Jun 4th](https://canvas.sfu.ca/courses/44038/quizzes/166553 ':class=button') @@ -106,6 +108,7 @@ https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-de ``` ### 使用 iFrame 嵌入 Docsify-This 网页 + 你可以在几乎所有的平台上使用 iFrame 嵌入 Docsify-This 网页。你还可以使用 URL 参数来确保你的嵌入内容与你的目标平台相匹配： ``` @@ -123,13 +126,14 @@ url=https://docsify-this.net/?basePath=https://raw.githubusercontent.com/paulhib ``` ### 整合 Docsify-This 和 Git -为了充分利用版本控制的好处，并使用 **编辑此页面** Edit this Page 的链接进行协同工作，请将你的 Docsify-This Markdown 文件存储在 Codeberg 或 GitHub 的 Git 存储库中。一些开源工具为 Git 提供了一个图形界面，包括 [GitHub Desktop][13]（最近已开源）、[Git-Cola][14] 和 [SparkleShare][15]。文本编辑器 VSCode 和 Pulsar Edit（以前的 [Atom.io][16]）也都有整合 Git 的功能。 -**你可以点击这个链接，来看看 [Git 小技巧][17]电子书** +为了充分利用版本控制的好处，并使用 “编辑此页面Edit this Page” 的链接进行协同工作，请将你的 Docsify-This Markdown 文件存储在 Codeberg 或 GitHub 的 Git 存储库中。一些开源工具为 Git 提供了一个图形界面，包括 [GitHub Desktop][13]（最近已开源）、[Git-Cola][14] 和 [SparkleShare][15]。文本编辑器 VSCode 和 Pulsar Edit（以前的 [Atom.io][16]）也都有整合 Git 的功能。 ### 轻松实现 Markdown 文件在网页发布 -由于 Docsify 的存在，每个人都能享受到Markdown 文件的在网上发布的好处。而且由于 Docsify-This 的出现，这个工作变得很容易。不妨在 [Docsify-This 网站][1] 上试试吧。 +由于 Docsify 的存在，每个人都能享受到 Markdown 文件的在网上发布的好处。而且由于 Docsify-This 的出现，这个工作变得很容易。不妨在 [Docsify-This 网站][1] 上试试吧。 + +*（题图：MJ/f38f0a40-002b-4e93-9697-e008205c1211）* -------------------------------------------------------------------------------- @@ -138,7 +142,7 @@ via: https://opensource.com/article/23/5/docsify-markdown-html 作者：[Paul Hibbitts][a] 选题：[lkxed][b] 译者：[chai001125](https://github.com/chai001125) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -161,3 +165,4 @@ via: https://opensource.com/article/23/5/docsify-markdown-html [15]: https://opensource.com/article/19/4/file-sharing-git [16]: https://opensource.com/article/20/12/atom [17]: https://opensource.com/downloads/git-tricks-tips +[0]: https://img.linux.net.cn/data/attachment/album/202306/07/000552k4mcssc66v44cfc8.jpg \ No newline at end of file