Người mới bắt đầu thiết lập Plugin tích hợp Zotero của AidenLX

Tài liệu chính thức hiện tại chưa đầy đủ và không thể truy cập được đối với hầu hết người dùng, tuy nhiên tôi tin rằng đây là sự tích hợp zotero tốt nhất cho đến nay, nếu cuối cùng nó có thể phù hợp với các tính năng của Bibnotes Formatter . Tôi muốn tạo một hướng dẫn đơn giản cho người dùng muốn thiết lập nhanh plugin với các trường hợp sử dụng đơn giản.

Trong hướng dẫn này, tôi sẽ chắt lọc những gì tôi thu thập được sau một ngày xem qua chuỗi diễn đàn Obsidian , các trang thảo luận và vấn đề về github , hướng dẫn API từ tài liệu cũng như bản dùng thử và lỗi brute-force. Phần lớn nội dung api sẽ yêu cầu kiến thức về eta và javascript, rất tiếc là tôi có ít kinh nghiệm về nó. Có lẽ những người khác có thể tham gia và giúp tôi điền vào bảng tóm tắt các mẫu đơn giản và các trường hợp sử dụng.

Tôi sẽ không đề cập đến việc cài đặt vì điều đó đã được đề cập đầy đủ trong tài liệu chính thức cũng như một số nội dung đơn giản như cài đặt thư mục được xác định trước và các nội dung khác.

Giải thích các tính năng

Bên cạnh việc tạo ghi chú trích dẫn (như họ gọi là “Ghi chú văn học”) bằng cách nhập dữ liệu từ zotero, Plugin tích hợp zotero của AidenLX (mà bây giờ tôi sẽ gọi là AZP), còn có một số tính năng dành cho nghiên cứu. Cụ thể là hai thanh công cụ, Bảng Ghi chú Trường Văn học và Bảng Chú thích.

Bắt đầu với Bảng ghi chú trường văn học , đây là bảng được liên kết với khung hoạt động và sẽ hiển thị cho bạn nội dung của các trường ngoại vi siêu dữ liệu yaml (phải được chỉ định trong cài đặt plugin). Ngoài ra, bạn có thể thêm các mục mới vào các trường này từ bảng này. Các trường mặc định được chỉ định là phần đánh dấu và chú thích . Bạn có thể thêm các trường bổ sung để hiển thị trong chế độ xem này bằng cách đi tới cài đặt plugin và chọn tab fields.

Bảng chú thích phức tạp hơn. Mục đích chính của bảng này là hiển thị các chú thích được tạo bằng zotero Trong bảng bên. Ở đây có bốn tùy chọn, “thu gọn” (rút ngắn thẻ chú thích), “làm mới” (làm mới dữ liệu từ zotero), “Chọn Chế độ theo dõi” và “Hiển thị chi tiết”. Chế độ Chọn Theo dõi , liên kết bảng chú thích với: tài liệu đã chọn (được chọn từ danh sách), ghi chú tài liệu trong bảng đang hoạt động hoặc “tài liệu đang hoạt động trong trình đọc zotero” (Tôi không thể làm cho tài liệu này hoạt động được ). Cuối cùng, có chế độ Hiển thị chi tiết , đối với tài liệu được liên kết, sẽ hiển thị các trường siêu dữ liệu có sẵn từ zotero (điều này được cho là hiển thị bên trong bảng điều khiển, nhưng theo kinh nghiệm của tôi, nó hoàn toàn mở trong một cửa sổ Obsidian mới). Chúng cũng có thể được tìm thấy bằng cách mở tệp cơ sở dữ liệu Betterbibtex .json. Những tên trường này là những gì bạn sẽ sử dụng khi tạo mẫu của mình, như sẽ được giải thích bên dưới,

Mẫu

Hiện tại, khung tạo khuôn mẫu được chia thành nhiều phần. Các trường siêu dữ liệu Yaml không được tích hợp vào các tệp mẫu có thể tùy chỉnh và thay vào đó được chỉnh sửa từ Templatetab trong cài đặt bên dưới tiêu đề Trường siêu dữ liệu . Tại đây, bạn có thể chọn siêu dữ liệu nào bạn muốn nhập từ zotero và vào các trường yaml. Bạn cũng có thể chọn tùy chỉnh tên trường được in trong Ghi chú Văn học thành tên khác với tên trường trong zotero với Specify Alias Heretrường văn bản. Các trường không tồn tại trong zotero sẽ không được tạo trong mẫu và không thể xác định các trường yaml không phải zotero tùy chỉnh, tức là các trường mà bạn có thể muốn cho obsidian, chẳng hạn như statushoặc priority. Không phải là vấn đề lớn nếu bạn là người yêu thích các trường nội tuyến của chế độ xem dữ liệu.

AZP sử dụng các mẫu mặc định cho đến khi chúng được “đẩy” vào một thư mục xác định. Việc này được thực hiện trong Templatetab trong cài đặt, sau đó các tệp mẫu có thể được tùy chỉnh. Theo mặc định, những cái này zt-note.eta, zt-annot.etavà những cái tên tương tự zt-annots.eta. Cách thức hoạt động này trước tiên là tham khảo mẫu ghi chú : zt-note.eta, sau đó tham chiếu zt-annots.etamột mẫu riêng để biết cách tạo nhiều chú thích và tham chiếu zt-annot.etaxác định mẫu cho từng chú thích riêng lẻ.

Dưới đây tôi đã sao chép các mẫu mặc định và mô tả hành vi trong phần nhận xét. Xin nhắc lại, về cơ bản tôi không có kinh nghiệm về JS nên điều này chủ yếu dựa vào trực giác.

# &lt;%= it.title %&gt; \\ Insert title from zotero metadata<span></span>
\n              \\ New line break<span></span>
[zotero](&lt;%= it.backlink %&gt;) &lt;%= it.fileLink %&gt; \\ Creating a markdown link "[]()" which links to the           zotero URI, and then a link to the file location <span></span>
\n              \\ New line break<span></span>
&lt;%~ include("annots", it.annotations) %&gt; \\ Reference to insert "annots" template (kinda iffy here)<span></span>

\\ Super unsure to the format of things here<span></span>
&lt;% for (const annotation of it) { %&gt; \\Probably a "for all annotations in item" <span></span>
&lt;%~ include("annotation", annotation) %&gt; \\ Make a an individual annotation item from zt-annot.eta, I don't see how it is referenceing that template file exactly<span></span>
\n \\ newline break<span></span>
&lt;% } %&gt; \\ Exit for loop?<span></span>

[!note] Page &lt;%= it.pageLabel %&gt; \\ Makes an admontion with the page number<span></span>
&lt;%= it.imgEmbed %&gt; \\ Embeds image if one<span></span>
&lt;%= it.text %&gt; \\ Text selected of annotation<span></span>
<span></span>
&lt;% if (it.comment) { %&gt; \\ if loop for comments on annotation<span></span>
---<span></span>
&lt;%= it.comment %&gt; \\ insert annotation comment<span></span>
&lt;% } %&gt; \\exit if loop<span></span>

Tôi cho rằng có thể có các tùy chọn để định dạng chú thích theo nội dung hoặc màu sắc, nhưng đòi hỏi sự hiểu biết sâu sắc hơn về JS/eta hơn tôi hiểu. Như đã đề cập trước đây, tài liệu chính thức có thông tin API phong phú, nhưng tôi thực sự không thể hiểu được phần đầu hay phần cuối của nó. Nếu bạn đọc phần này có thể thêm một số thông tin để trợ giúp về một số định dạng này, vui lòng liên hệ.

Bảng cheat cú pháp

Ngay lập tức chúng ta có thể thấy cách chèn thông tin hoạt động như thế nào:

<% %>Bất kỳ ai quen thuộc với plugin templater sẽ nhận ra đây là đại diện cho một trường động, tức là thông tin sẽ được lấy tự động.

<%= it.fieldname %>dường như là cách người ta thiết lập thông tin từ một trường trong zotero trong đó it.viết tắt của “item” (vì vậy đừng thay đổi điều này) và fieldnamelà trường zotero mà thông tin được lấy ra từ đó. Chỉ cần hoán đổi tên trường với các trường zotero mong muốn, như được hiển thị trong bảng Hiển thị chi tiết hoặc .jsontệp.


<% for { %>

và

<% if {%>

dường như đóng vai trò là một hàm động, tương ứng cho vòng lặp for và if . Kết thúc câu lệnh cần phải kết thúc bằng

<% } %>

Như đã thấy trong

<% if (it.comment) { %>

và

<% for (const chú thích của nó) { %>

<%~ %>

dường như là một hàm động nào đó, như được thấy trong

<%~ include("annotation", chú thích) %>

. điều đó kêu gọi zt-annots.eta nhưng đây là giới hạn hiểu biết của tôi.

Bảng cheat trường

<%= it.title %>

tiêu đề bài viết

<%= it.date %>

năm


<%= it.backlink %>

URI Zotero

<%= it.fileLink %>

Đường dẫn tệp Zotero PDF


<%= it.abstractNote %>

chèn phần tóm tắt

Phần thưởng - Cách rút ngắn tên tác giả thành et al

Như được lấy từ chủ đề này ở đây , nó sử dụng ngôn ngữ js/eta để định dạng tên tác giả là “tác giả đầu tiên và cộng sự. Năm” khi có nhiều hơn một tác giả được liệt kê.

&lt;%= it.creators.first()?.lastName %&gt;<span></span>
&lt;% if (it.creators.length &gt; 1) { %&gt; et al. &lt;% } %&gt;<span></span>
- &lt;%= it.date %&gt; - &lt;%= it.title %&gt;<span></span>

Cuối cùng

Điều này là đủ để tùy chỉnh một số mẫu đơn giản. Nếu bạn có bất kỳ thông tin nào có thể hoạt động tốt ở đây, vui lòng liên hệ với các chủ đề diễn đàn hoặc reddit liên kết ở đây và tôi sẽ cố gắng kết hợp nó.

Ngoài ra, vui lòng xem github của AidenLX hoặc quyên góp cho người bảo trợ của anh ấy .

Ngoài ra, có lẽ hãy xem chuỗi diễn đàn Obsidian này tại đây để biết thêm thảo luận về mẫu AZP.