This page looks best with JavaScript enabled

Hugo with OrgMode

 ·  ☕ 1 min read  ·  🎅 [emacle] · 👀... views
  1. elpa 安装 ox-hugo

  2. 优先使用基于子树模式 两个必填 <hugo_base_dir> 与 EXPORT_FILE_NAME

    • org 文件头 设置配置 #+hugo_base_dir 参数指向 hugo 工程目录

      1
      
      #+hugo_base_dir: ../hugo
      
    • subtree 属性必须要设置 EXPORT_FILE_NAME 即slug 不可重复, 作为导出的 .md 文件名

      1
      
      :EXPORT_FILE_NAME: hugo-with-orgmode
      
    • 导出sub-tree到 <HUGO_BASE_DIR>/content/posts/

      1
      
      C-c e H H 或 C-c e H O
      

      子树如果是 DONE 则 会直接发布, 如果是 TODO 则会做为草稿

  3. Sub-tree 属性 EXPORT_HUGO_TAGS 与 EXPORT_HUGO_CATEGORIES

    • 多个参数以 空格 分隔

    • 会覆盖 orgmode 里的 tags 属性, 留空或不设置则会继承 orgmode tags

    • @ 开头的 orgmode tags 可表示 CATEGORIES

    1
    2
    
    :EXPORT_HUGO_TAGS: hugo haha
    :EXPORT_HUGO_CATEGORIES: orgmode emacs
    

    可不用使用 CATEGORIES 能与 orgmode 保持一致, 前端配置可去除该链接
    EXPORT_HUGO_TAGS 也可以留空, 只使用org tags 方式

    属性插入可编写 yasnippet , 利用自定义函数 hugoslug-to-pinyin, 插入时自动将
    head title里的中文转换成拼音

  4. org本地图片可以无描述插入可直接导出正确的url格式

    1
    
    [[file:images/80px-Heckert_GNU_white.svg.png]] 描述为空不能单击图片链接
    
    1
    
    [[desc][link]] 描述不为空 图片可单击打开,i.e. (org-store-link) 保存的链接
    
    1
    
    [[https://raw.githubusercontent.com/emacle/picgo/master/img/icon_a.png]]  远程 image url
    
    1
    
    MiniCap.exe 截图 / FastStone 简单特效/标注/绘画马赛克/文字放大镜/中心聚光模糊效果 / picpick.exe 卡
    
    1
    2
    3
    4
    5
    6
    7
    8
    
    # 1.初始化一个hugo工程目录
    hugo new site mysite
    # 2. 必须在 mysite/themes 里 git 下载主题 如无mysite/themes目录 则手动创建
    # 3. cd mysite 测试
    # > hugo.exe new posts/my-first.md 生成 .md -> 编辑
    hugo.exe serve
    # 4. 发布, 在hugo文件夹下自动生成一个public文件夹 将public托管 -b 指定baseURL
    hugo.exe -b https://emacle.github.io/
    

emacle
WRITTEN BY
[emacle]
Emacser orgmode

 

What's on this Page