使用ox-hugo的常用功能记录

Last updated on 2021年9月20日 2 min read

缘起

在使用ox-hugo过程中发现很多功能一旦不用就会遗忘，对常用的一些功能特此记录。

使用page bundle

nil:END:

#+begin_src org :PROPERTIES: :EXPORT_FILE_NAME: index :EXPORT_HUGO_BUNDLE: your-page-bundle-name

#+end_src

插入图片

#+ATTR_HTML: :alt 照片的alt

#+caption: 照片的标题

[[file:9d6855f4gy1fj404ppi8vj21mc1mc7vt.jpg]]

以下是可以点击的照片
#+ATTR_HTML: :alt 照片的alt :width 400

#+caption: 照片的标题

[[file:9d6855f4gy1fj404ppi8vj21mc1mc7vt.jpg][file:9d6855f4gy1fj404ppi8vj21mc1mc7vt.jpg]]

:width 400 的意思是显示图片的宽度指定为400

插入视频

优酷，使用html代码分享框

插入说明框

#+begin_note
See the [[https://ox-hugo.scripter.co/doc/examples/][Real World Examples]] section to quickly jump to sites generated
using =ox-hugo= and their Org sources.
#+end_note

效果如下（不同的CSS会不所不同）：

See the Real World Examples section to quickly jump to sites generated using ox-hugo and their Org sources.

如不使用说明框的效果：

See the Real World Examples section to quickly jump to sites generated using ox-hugo and their Org sources.

插入链接

有序列表中的代码块

在一次RSS中看到一篇文章：Hugo 写博文，生成的markdown的有序列表显示有问题

过程略过了，最终的结果是在有序列表之间可以插一个代码块之后，下一个有序列表可以继续编号

解决了： disable code fence， 在你的 org file最上面添加配置： #+hugo_code_fence: nil 写 org src的时候添加一个缩进： 如果没有缩进，生成的markdown的序号也是不正确的。 总结一下： markdown里面有序列表中如果插入代码，希望代码后面的序号有序，需要给 source code block 添加缩进。

1. 有序列表
 #+BEGIN_EXAMPLE
 在#号之前加一个空格

1.

#+END_EXAMPLE

插入自定义的front matter

  • subtitle :EXPORT_HUGO_CUSTOM_FRONT_MATTER: :subtitle 你想要的副标题
  • author :EXPORT_AUTHOR 作者 也可以在文件头中写入 #+author: 作者 第一种的优先级高于第二种
  • summary :EXPORT_HUGO_CUSTOM_FRONT_MATTER: :summary "一个能源管理系统"
  • 注意：如果是自定义front matter有两个以上的话，要写在一行中，如： :EXPORT_HUGO_CUSTOM_FRONT_MATTER: :summary XX :subtitle YY

还待确认的功能

HUGO_SECTION
The default Hugo section name
Orgmode Hugo
海上一民工

Related