ZoteroonDocshttps://hiraethecho.github.io/docs/tags/zotero/Recent contentinZoteroonDocsHugo --0.152.2enwyz2016zxc@outlook.com(Hiraeth)wyz2016zxc@outlook.com(Hiraeth)Mon, 16 Mar 2026 15:39:39 +0800用mkdocs、obsidian、zotero搭建在线文献学习笔记https://hiraethecho.github.io/docs/dev/3in1wiki/Tue, 15 Oct 2024 00:00:00 +0000wyz2016zxc@outlook.com(Hiraeth)https://hiraethecho.github.io/docs/dev/3in1wiki/<h1 id="使用mkdocsobsidianzotero搭建在线文献学习笔记"> <a class="anchor inpage" href="#%e4%bd%bf%e7%94%a8mkdocsobsidianzotero%e6%90%ad%e5%bb%ba%e5%9c%a8%e7%ba%bf%e6%96%87%e7%8c%ae%e5%ad%a6%e4%b9%a0%e7%ac%94%e8%ae%b0">#</a>使用mkdocs、obsidian、zotero搭建在线文献学习笔记</h1> <p>工作流是，在zotero中阅读和标记。用zotero-better-notes插件把标记变成文本格式，并且导出到obsidian的库文件中，进一步编辑（或者用nvim编辑）。在obsidian中更方便笔记链接跳转，zotero只是文献管理和阅读。然后把笔记同步到mkdocs的git仓库（实际上是把mkdocs的文件夹软链接到obsidian库），用github pages搭建在线wiki。</p> #使用mkdocs、obsidian、zotero搭建在线文献学习笔记

工作流是，在zotero中阅读和标记。用zotero-better-notes插件把标记变成文本格式，并且导出到obsidian的库文件中，进一步编辑（或者用nvim编辑）。在obsidian中更方便笔记链接跳转，zotero只是文献管理和阅读。然后把笔记同步到mkdocs的git仓库（实际上是把mkdocs的文件夹软链接到obsidian库），用github pages搭建在线wiki。

##设置

###Zotero

关键是zotero-better-note插件的 ：从注释创建笔记；将笔记插入到其他笔记；将笔记导出为markdown。

IMPORTANT

导出路径和模板中链接路径有硬编码部分，需要根据具体情况手动修改。

###obsidian

需要在设置中选择使用markdown风格链接而不是wiki风格。根目录/是obsidian的库文件夹。

###mkdocs

基本上就是直接使用模板。

##路径匹配

主要需要注意的，是文件名和链接格式，即[markdown格式的链接](这里应该写什么路径)，使得zotero、obsidian、在线网页的跳转都正常。实际上有两个跳转，一个是到md文件的跳转，另一个是到pdf的跳转。前者是obsidian或网页内的跳转，相对简单；后者是跳转到zotero中的pdf，这个实际上只有我能用，因为涉及到zotero的数据库。有多种选择：

###docs文件夹作为obsidian仓库

创建仓库username.github.io（必须是这个格式），在线网页会是https://<username>.github.io，那么链接应该写成[title](/filename)，在网页端是https://<username>.github.io/filename。把docs/文件夹作为obsidian repo，用.gitignore忽略掉docs/.obsidian。

优点是简单，缺点文件直接在obsidian的根目录，不好管理其他内容了。

###docs文件夹作为obsidian仓库子文件夹

使用二级域名的github pages，即创建仓库（例如wiki），在线网页会是https://<username>.github.io/wiki，那么链接应该写成[title](/wiki/filename)，在网页端是https://<username>.github.io/wiki/filename

把docs变成obsidian的子文件夹，可以用软链接：

sh
ln -s /path/to/git/repo/docs /path/to/obsidian/repo/wiki

或者用

##总结

NOTE

似乎需要一个markdown和latex转换的脚本。其中markdown应该混写html比较好。似乎lua就可以，那么就可以做nvim插件。
2025-05-21: 似乎latex转markdown+html比较好，用<ul> <ol> <detail>标签来处理latex环境itemize enumerate Theorem

]]>zoterohttps://hiraethecho.github.io/docs/software/zotero/Mon, 13 Nov 2023 00:00:00 +0000wyz2016zxc@outlook.com(Hiraeth)https://hiraethecho.github.io/docs/software/zotero/<h1 id="zotero"> <a class="anchor inpage" href="#zotero">#</a>Zotero</h1> <h2 id="install-and-basic-setting"> <a class="anchor inpage" href="#install-and-basic-setting">##</a>Install and basic setting</h2> <h2 id="plugins"> <a class="anchor inpage" href="#plugins">##</a>Plugins</h2> <p><strong>zotero 7:</strong></p> <p>常用：</p> <ul> <li>Zotero attanger</li> <li>Del item with Attachment</li> <li>Ethereal Reference</li> </ul> <p>好用：</p> <ul> <li>zotero better notes</li> </ul> <p>没必要但可以：</p> <ul> <li>Ethereal Style</li> <li>Attachment Scanner</li> <li>arXiv Workflow for zotero</li> <li>Zoplicate</li> <li>Linter for zotero</li> </ul> <h2 id="sync"> <a class="anchor inpage" href="#sync">##</a>Sync</h2> <p>using <del>zotmoov</del> attanger to move files</p> <p>zotero 7 to rename:</p> <details open> <summary>TEXT</summary><pre class="codeblock" ><code class="language-" data-lang="">{{ title case=&#34;snake&#34; }}{{ creators case=&#34;snake&#34; prefix=&#34;_&#34; max=&#34;1&#34;}}{{ year prefix=&#34;_&#34; }}</code><button onclick="copyCode(this)" class="copybtn">copy</button></pre></details> <script> function copyCode(btn) { const code = btn.previousElementSibling.textContent.trim(); navigator.clipboard.writeText(code).then(() => { btn.innerText = "copied"; setTimeout(() => (btn.innerText = "copy"), 2000); }); } </script><p>use any cloud drive to sync. I&rsquo;m using koofr.</p> #Zotero

##Install and basic setting

##Plugins

zotero 7:

常用：

  • Zotero attanger
  • Del item with Attachment
  • Ethereal Reference

好用：

  • zotero better notes

没必要但可以：

  • Ethereal Style
  • Attachment Scanner
  • arXiv Workflow for zotero
  • Zoplicate
  • Linter for zotero

##Sync

using zotmoov attanger to move files

zotero 7 to rename:

TEXT
{{ title case="snake" }}{{ creators case="snake" prefix="_" max="1"}}{{ year prefix="_" }}

use any cloud drive to sync. I’m using koofr.

##zotero better notes

用来

templates: you can copy these:

quickinsert
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[QuickInsertV2]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T07:59:45.835Z"
content: |-
  // @use-markdown
  <a href="${link}">${linkText}</a> [md](/wiki/math/zotero/${subNoteItem.getNoteTitle ? subNoteItem.getNoteTitle().replace(/[/\\?%*:|"<> ]/g, "-") + "-":""}${subNoteItem.key})
quickimport
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[QuickImportV2]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T05:54:37.696Z"
content: |-
  <blockquote>
  ${{
    return await Zotero.BetterNotes.api.convert.link2html(link, {noteItem, dryRun: _env.dryRun});
  }}$
  </blockquote>
quicknote
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[QuickNoteV5]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T05:54:55.255Z"
content: |-
  ${{
    let res = "";
    if (annotationItem.annotationComment) {
      res += await Zotero.BetterNotes.api.convert.md2html(
        annotationItem.annotationComment
      );
    } else {
  	res += "No comment";
    }
    return res;
  }}$

  // @use-markdown
  ***
  ${{
  	let res = "";
    res += await Zotero.BetterNotes.api.convert.annotations2html([annotationItem], {noteItem, ignoreComment: true});
    return res;
  }}$
exportmdfilename
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileNameV2]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T05:55:24.890Z"
content: |-
  ${(noteItem.getNoteTitle ? noteItem.getNoteTitle().replace(/[/\\?%*:|"<> ]/g, "-") + "-" : "")}${noteItem.key}.md
exportmdfileheader
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileHeaderV2]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T05:55:34.047Z"
content: |-
  ${{
    let header = {};
    header.tags = noteItem.getTags().map((_t) => _t.tag);
    header.parent = noteItem.parentItem
      ? noteItem.parentItem.getField("title")
      : "";
    header.collections = (
      await Zotero.Collections.getCollectionsContainingItems([
        (noteItem.parentItem || noteItem).id,
      ])
    ).map((c) => c.name);
    return JSON.stringify(header);
  }}$
exportmdfilecontent
# This template is specifically for importing/sharing, using better
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileContent]"
zoteroVersion: "7.0.9.SOURCE.fadbf3d2d"
pluginVersion: "2.0.18"
savedAt: "2024-11-07T05:56:22.434Z"
content: |-
  ${{
    let start = mdContent;
    let rmspan = start.replace(/<\/?span.*?>/g,'');
    let pdflink = rmspan.replace(/(<a .*?open.*?>)“(.*?)”/g,'$2 $1(pdf)</a>');
    let dir2zotero = pdflink.replace(/<a href.*?zhref="(.*?)" ztype.*?>/g,'<a href="$1">');
    return dir2zotero;
  }}$

annotation will be exported as

TEXT
<span class="highlight" data-annotation="<data-annotation>" ztype="zhighlight"><a href="zotero://open/library/items/G4BKVA2X?page=2&#x26;annotation=LZLEYYRJ">“<content>”</a></span> <span class="citation" data-citation="<citation>" ztype="zcitation">(<span class="citation-item"><a href="zotero://select/library/items/GLXUZZJT"></a></span>)</span>

the color of annotation is coded as %23<rgb> in <data-annotation>, for example blue (#2ea8e5) annotation is %232ea8e5

]]>