文档链接和附件

by Metanote Team in misc on 2024-11-26 Translations: en

1. 概述

从 Metanote 0.15.0 版本开始支持大部分 org mode 中的链接功能。

需要特别说明的是,在 Metanote 中只支持打开相对路径的文档链接,绝对路径和远程的文档链接,比如 file://ssh:someone@soomewhere:doc/doc.pdf 可识别,但无法打开,因为移动端的路径与 PC 端是不同的。这包括对于 attachments 路径的设置,如果是绝对路径您可能会无法打开 attachments.

2. 链接格式

  1. 支持标准格式,且在标准格式的链接中出现 '[' ']' 等特殊字符时可自动转义,与 org mode 完全兼容

    [[LINK][DESCRIPTION]]
    [[LINK]]
    
  2. 支持 <link>
  3. 支持 Plain link
  4. Link Abbreviations 尚未支持
  5. Corderef 类型的链接可识别,但无法执行 shell, elisp 等命令

3. 内部链接

  1. 支持链接到 custom id

    [[#my-custom-id]]
    
  2. 支持链接到 dedicated target
  3. 支持链接到 #+NAME keyword
  4. Radio Targets 暂时尚未支持

4. 外部链接

支持以下外部链接

  1. file
    1. 'file:/home/data/images/a.jpg'
    2. '/home/data/images/a.jpg'
    3. 'file:doc/doc.pdf'
    4. './doc/doc.pdf'
    5. 'file:test.org'
    6. 'file:test.org::NNN' 跳转到行号
    7. 'file:test.org::my target' 跳转到 dedicated target
    8. 'file:projects.org::*headline title' 跳转到某 headline
    9. 'file:projects.org::#custom-id' 跳转到某 custom id 的 headline
  2. attachment
  3. docview
  4. http/https

5. 保存,插入,打开和编辑链接

  1. 在任意内部 org 文件中通过编辑菜单 'Copy link' 保存文档链接,可自动识别 dedicated target, #+NAME, headline title 等
  2. 'Copy link' 后在任意内部 org 文件的任意位置粘贴文档链接,可自动识别内部链接或外部链接,并转换为正确的相对路径。注意需要在同一个 location 下。
  3. 通过插入面板直接插入和编辑链接
  4. 点击链接可以打开或编辑链接

6. 附件   ATTACH

2024-11-29_11-21-58_insert attachments.png

  1. 支持多种链接或附件的打开预览和简单编辑,比如
    1. iWork and Microsoft Office documents
    2. Images
    3. Live Photos
    4. Text files
    5. PDFs
    6. Audio and video files
  2. attachment 目录可指定多种类型的 ID,但如果未指定,暂时只支持自动创建 UUID 类型 ID
  3. attachment 目录支持单独设置 PROPERTY dir 目录或 ID,或在 InBufferSettings 中设置
  4. 支持从插入面版直接选择附件插入,附件将会被复制到指定的 attachment 目录,如果 attachment 目录不存在则会自动创建 UUID 目录