跳到正文 Htmlpress静态站点生成器 Htmlpress静态站点生成器

切换主题

键盘快捷键

链接

更新于

每个页面都在它自己的文件夹 URL 上提供:guides/build.html 对应 /guides/build/,index.html 则在其所在文件夹提供, guides/index.html 对应 /guides/。与 Livemark 一样,每个文件夹名和文件名都会转换为 slug:User Guide/Getting Started.html 对应 /user-guide/getting-started/。可以按 URL 链接页面,也可以按文件链接:指向页面文件的链接,无论是相对的还是根相对的,都会被改写为该页面的 URL,其他相对 URL 则从源文件所在位置解析。

内部链接

链接到文档中的其他页面,可以相对于根目录,也可以相对于当前页面:

<a href="/introduction/">Introduction</a>
<a href="headings.html">Headings</a>
[Introduction](/introduction/)
[Headings](headings.html)

渲染为:简介

在 htmlpress.yaml 中设置 base 后,构建中的每个根相对 URL(位于 href、src、srcset、poster 和 action 中,无论是在页面、布局还是配置的 HTML 里)都会加上它作为前缀:写 /guide/,站点就会链接到 /repo/guide/。相对 URL 和绝对 URL 保持不变,页面自身 CSS 中的 url() 也一样。start 和 preview 同样在基础路径下提供站点,并把 / 重定向到那里。

导航把一个文件夹的页面归到它的 index.html 之下,组名取自该页面的标题。组名链接到该索引页,旁边的箭头可以折叠该组。没有 index.html 的文件夹不构成分组:其页面与根目录的页面一起位于顶层。

外部链接

链接到外部资源:

<a href="https://github.com">GitHub</a>
[GitHub](https://github.com)

渲染为:GitHub

锚点链接

通过 ID 链接到当前页面的某个标题:

<a href="#internal-links">See Internal Links</a>
[See Internal Links](#internal-links)

渲染为:参见内部链接

其他页面上的标题就是该页 URL 加上 ID: 自定义标题 ID。ID 的生成方式见 标题。

自动链接

正文中的裸 URL 会在构建时变成链接,与 GitHub 风格的 Markdown 一样: http:// 和 https:// URL、www. 地址以及电子邮件地址。末尾的标点留在链接之外。

<p>See https://htmlpress.dev, or mail team@example.com.</p>
See https://htmlpress.dev, or mail team@example.com.

渲染为:详见 https://htmlpress.dev ,或发邮件至 team@example.com 。

链接、代码、代码块和终端中的文本保持原样,任何带 data-literal 的元素也是如此,适用于必须显示原始 URL 的正文:

<p data-literal>Type https://htmlpress.dev in the address bar.</p>
<p data-literal>Type https://htmlpress.dev in the address bar.</p>

用 ❤ 和 Htmlpress 构建

操作

在 GitHub 上编辑以 Markdown 查看

目录