citar
v1.3.0 - configurable indicators
Citar นำเสนอฟรอนต์เอนด์ completing-read ที่มีการกำหนดค่าสูงเพื่อเรียกดูและดำเนินการกับข้อมูลบรรณานุกรม BibTeX, BibLaTeX และ CSL JSON และรองรับการแก้ไข LaTeX, markdown และ org-cite
citar-embark ขนาดเล็กที่ให้การดำเนินการตามบริบทในมินิบัฟเฟอร์ และยังมี at-point ในบัฟเฟอร์ org, markdown และ LaTeXorg-roam , denote และ zkนี่คือภาพหน้าจอที่มีการปรับแต่งแนวตั้งและสัญลักษณ์ตามที่ระบุไว้ด้านล่าง
และนี่คือ citar-capf ในบัฟเฟอร์มาร์กดาวน์
หากต้องการดูการทำงานของ citar ด้วย org-cite คุณสามารถชมการนำเสนอ Emacs Conf 2021 โดย Ahmed Khaled
มีหลายวิธีในการติดตั้งซิตาร์:
vertico Completeemacs-citarนอกจากนี้ เราขอแนะนำแพ็กเกจต่อไปนี้อย่างยิ่งเพื่อประสบการณ์ที่ดีที่สุด
โดยเฉพาะอย่างยิ่ง หากคุณต้องการจำกัดการค้นหาให้แคบลงโดยใช้ผู้แต่ง ชื่อเรื่อง ฯลฯ (เช่น ไม่ใช่แค่คีย์การอ้างอิง) คุณต้องใช้รูปแบบการเติมที่สมบูรณ์ซึ่งเป็นอิสระตามลำดับ ตัวอย่างเช่น Orderless โดยตั้ง completion-styles เป็น (orderless basic) (ดูตัวอย่างการกำหนดค่า)
เราขอแนะนำ Emacs 28 หรือใหม่กว่าด้วย
นี่เป็นการกำหนดค่าขั้นต่ำ และจะทำงานร่วมกับ UI การเติมข้อมูลแนวตั้งที่สอดคล้องกับการอ่านให้สมบูรณ์ เช่น Vertico หรือ icomplete-vertical ในตัว พร้อมการดำเนินการที่ทำได้ผ่านคำสั่ง Mx
( use-package citar
:custom
(citar-bibliography '( " ~/bib/references.bib " )))citar-capf แพ็คเกจนี้ประกอบด้วยฟังก์ชัน completion-at-point เพื่อกรอกคีย์การอ้างอิงในบัฟเฟอร์ ซึ่งคุณสามารถกำหนดค่าได้ดังนี้:
( use-package citar
:custom
(citar-bibliography '( " ~/bib/references.bib " ))
:hook
( LaTeX-mode . citar-capf-setup)
( org-mode . citar-capf-setup)) แพ็คเกจ citar-embark เพิ่มการดำเนินการเข้าถึงตามบริบทใน minibuffer และ at-point ผ่านโหมดรองของ citar-embark-mode
เมื่อใช้ Embark การดำเนินการของ Citar จะเป็นแบบทั่วไป และทำงานเหมือนกันทั่วทั้งโหมดองค์กร มาร์กดาวน์ และลาเท็กซ์
( use-package citar-embark
:after citar embark
:no-require
:config (citar-embark-mode)) นี่แสดงการกระทำของบัฟเฟอร์ที่มีให้โดย citar-embark :
หากคุณต้องการใช้ Citar เฉพาะใน Org-Mode นี่เป็นตัวเลือกที่ดีที่สุด
( use-package citar
:no-require
:custom
(org-cite-global-bibliography '( " ~/bib/references.bib " ))
(org-cite-insert-processor 'citar )
(org-cite-follow-processor 'citar )
(org-cite-activate-processor 'citar )
(citar-bibliography org-cite-global-bibliography)
; ; optional: org-cite-insert is also bound to C-c C-x C-@
:bind
( :map org-mode-map :package org ( " C-c b " . # 'org-cite-insert ))) คุณสามารถแทรกการอ้างอิงด้วยคำสั่ง org-cite-insert ซึ่งผูกไว้กับ Cc Cx C-@ ในบัฟเฟอร์ Org-Mode คำสั่งเสริม :bind ด้านบนยังทำให้การเชื่อม Cc b สั้นลงอีกด้วย
หากคุณต้องการให้เมนู Embark เปิดด้วย org-open-at-point คุณควรตั้งค่าตัวแปรนี้
( setq citar-at-point-function 'embark-act ) คุณสามารถเรียกใช้ทั้ง embark-act และ embark-dwim โดยไม่ขึ้นกับ org-at-point และในโหมดอื่นๆ เช่น latex-mode
Citar มีเฟรมเวิร์กอะแดปเตอร์เพื่อให้สามารถรวมการแก้ไขเฉพาะโหมดหลักได้ อะแด็ปเตอร์ดังกล่าวสามารถจัดเตรียมความสามารถต่อไปนี้ ซึ่งสามารถกำหนดค่าด้วยรายการ citar-major-mode-functions :
insert-keys : เพื่อแทรกคีย์การอ้างอิง (แต่อาจหายไป)insert-citation : เพื่อแทรกการอ้างอิงinsert-edit : เพื่อแทรกการอ้างอิงหรือแก้ไขตรงจุดlocal-bib-files : เพื่อค้นหาไฟล์บรรณานุกรมที่เกี่ยวข้องกับบัฟเฟอร์key-at-point : ส่งคืนคีย์การอ้างอิงที่จุดcitation-at-point : ส่งคืนรายการคีย์ในการอ้างอิง ณ จุดปัจจุบัน Citar มีอะแดปเตอร์ดังต่อไปนี้:
citar-org : ตามค่าเริ่มต้น รองรับเฉพาะ org-cite เท่านั้น แต่สามารถกำหนดค่าสำหรับรูปแบบอื่นได้citar-latex : รองรับ bibtex, natbib และ biblatex ที่กำหนดค่าได้ (ต้องใช้ AUCTeX)citar-markdown : โดยค่าเริ่มต้น รองรับเฉพาะไวยากรณ์การอ้างอิง pandoc เท่านั้นสิ่งเหล่านี้ไม่ควรต้องมีการกำหนดค่าใดๆ และควรโหลดตามความจำเป็น
คำสั่ง citar-open-entry จะเปิดการป้อนข้อมูลต้นฉบับ คุณสามารถกำหนดค่านี้ได้โดยใช้ citar-open-entry-function ตามค่าเริ่มต้น จะใช้ citar-open-entry-in-file ซึ่งจะเปิดไฟล์บรรณานุกรมที่เกี่ยวข้องและย้ายชี้ไปที่รายการ ตัวเลือกอื่นที่รวมอยู่คือ citar-open-entry-in-zotero ซึ่งจะเลือกรายการใน Zotero โปรดทราบว่าฟังก์ชันการทำงานขึ้นอยู่กับ Better BibTeX (ซึ่งคุณควรจะใช้ต่อไป!)
UI การเรียกดูมีสามส่วน
คุณสามารถค้นหาจากเนื้อหาข้างต้นทั้งหมดได้ สำหรับคำนำหน้า คุณสามารถกรองไฟล์หรือบันทึกที่เกี่ยวข้องได้โดยใช้ has:file หรือ has:notes ตามลำดับ (และอย่างน้อยก็ไม่มี orderless แม้แต่ตัวย่อ :p หรือ :n ก็ตาม)
ตัวแปร citar-templates กำหนดค่าการจัดรูปแบบสำหรับส่วนเหล่านี้ รวมถึงฟังก์ชันบันทึกย่อเริ่มต้น นี่คือค่าเริ่มต้น:
( setq citar-templates
'((main . " ${author editor:30%sn} ${date year issued:4} ${title:48} " )
(suffix . " ${=key= id:15} ${=type=:12} ${tags keywords:*} " )
(preview . " ${author editor:%etal} (${year issued date}) ${title}, ${journal journaltitle publisher container-title collection-title}. n " )
(note . " Notes on ${author editor:%etal}, ${title} " )))บันทึก:
% นำหน้าโทเค็นที่กำหนดเป็นคีย์ใน citar-display-transform-functions ซึ่งค่าคือรายการฟังก์ชันและอาร์กิวเมนต์เผื่อเลือก โปรดทราบว่าหากคุณรวมสิ่งนี้ หากคุณรวมข้อกำหนดความกว้างด้วย จะต้องอยู่หลังความกว้างUI มีตัวบ่งชี้ที่กำหนดค่าได้ โดยค่าเริ่มต้น จะมีตัวบ่งชี้ข้อความธรรมดาสำหรับ ซึ่งแต่ละรายการบ่งชี้ถึงการมีอยู่ของทรัพยากรที่แตกต่างกันที่เกี่ยวข้องกับการอ้างอิง:
สำหรับตัวบ่งชี้อื่นๆ โปรดดูที่วิกิ
นี่คือภาพหน้าจอที่ใช้การกำหนดค่านี้ ซึ่งจะลบตัวบ่งชี้ลิงก์ และผสมข้อความธรรมดาและตัวบ่งชี้ไอคอนโดยใช้ all-the-icons
( setq citar-indicators
( list citar-indicator-files ; plain text
citar-indicator-notes-icons)) ; icon 
แน่นอนว่าคุณสามารถสร้างตัวบ่งชี้ของคุณเองได้ ต่อไปนี้คือตัวอย่างคำจำกัดความของตัวบ่งชี้ที่รวมไอคอน:
( defvar citar-indicator-notes-icons
(citar-indicator-create
:symbol (all-the-icons-material
" speaker_notes "
:face 'all-the-icons-blue
:v-adjust -0.3 )
:function # 'citar-has-notes
:padding " "
:tag " has:notes " ))อย่างไรก็ตาม โปรดทราบว่าฟังก์ชันเพรดิเคตที่รวมไว้นั้นจะต้องได้รับการปรับให้เหมาะสมที่สุด เนื่องจาก UI ที่เสร็จสมบูรณ์จะรันบนไลบรารีทั้งหมดของคุณทุกครั้งที่คุณเปิดมัน
Nerd-icons.el เป็นไลบรารีสำหรับการใช้ไอคอน Nerd Font ภายใน Emacs ได้อย่างง่ายดาย เป็นทางเลือกแทนไอคอนทั้งหมด และเป็นแพ็คเกจไอคอนที่รวมอยู่ใน Doom Emacs แล้ว นี่คือตัวอย่างของการทำให้รูปลักษณ์คล้ายกัน:
( defvar citar-indicator-notes-icons
(citar-indicator-create
:symbol (nerd-icons-mdicon
" nf-md-notebook "
:face 'nerd-icons-blue
:v-adjust -0.3 )
:function # 'citar-has-notes
:padding " "
:tag " has:notes " ))
( defvar citar-indicator-links-icons
(citar-indicator-create
:symbol (nerd-icons-octicon
" nf-oct-link "
:face 'nerd-icons-orange
:v-adjust -0.1 )
:function # 'citar-has-links
:padding " "
:tag " has:links " ))
( defvar citar-indicator-files-icons
(citar-indicator-create
:symbol (nerd-icons-faicon
" nf-fa-file "
:face 'nerd-icons-green
:v-adjust -0.1 )
:function # 'citar-has-files
:padding " "
:tag " has:files " ))
( setq citar-indicators
( list citar-indicator-files-icons
citar-indicator-notes-icons
citar-indicator-links-icons)) ไดเร็กทอรี test พื้นที่เก็บข้อมูลยังมีสคริปต์ที่คุณสามารถใช้เพื่อรันแพ็คเกจนี้และแพ็คเกจที่เกี่ยวข้องในแซนด์บ็อกซ์ emacs -Q หากต้องการทำเช่นนั้น เพียงเรียกใช้ ./run.sh จากไดเร็กทอรี test
citar มีฟังก์ชันการทำงานคล้ายกับฟังก์ชันการค้นหาที่กำหนดไว้ล่วงหน้าใน helm-bibtex และ ivy-bibtex แต่มีการใช้งานที่แตกต่างกัน แทนที่จะสร้างคำสั่งใหม่โดยใช้คำค้นหาเป็นอาร์กิวเมนต์ คุณเพียงแค่ตั้งค่าตัวแปร citar-presets และเพิ่มสตริงที่คุณต้องการเข้าถึง:
( setq citar-presets '( " one search string " " another search string " ))จากนั้นคุณมีสองวิธีในการเข้าถึงสตริงเหล่านี้จากพร้อมท์ให้เสร็จสิ้น:
Mn จากพรอมต์ ซึ่งจะวนไปตามสตริงcitar-insert-preset ด้วยการผูกปุ่ม จากนั้นเลือกสตริง citar ยังรักษาประวัติการเลือกของคุณ (ดูข้อแม้ด้านล่างเกี่ยวกับการเลือกผู้สมัครหลายราย) ซึ่งสามารถเข้าถึงได้ใน UI ที่เสร็จสมบูรณ์ของคุณ แต่โดยใช้ Mp คุณสามารถบันทึกประวัตินี้ข้ามเซสชันได้โดยเพิ่ม citar-history ลงใน savehist-additional-variables
Citar ใช้แคชเพื่อเพิ่มความเร็วในการแสดงไลบรารี หากไฟล์ bib เปลี่ยนแปลง แคชจะอัปเดตโดยอัตโนมัติในครั้งถัดไปที่คุณรันคำสั่ง Citar
โปรดทราบว่าข้อมูลที่แคชไว้ล่วงหน้าซึ่งผู้สมัครที่เสร็จสมบูรณ์จะถูกติดตามโดยไฟล์อย่างอิสระ ตัวอย่างเช่น ถ้าคุณมีไฟล์บรรณานุกรมขนาดใหญ่หนึ่งไฟล์ที่เปลี่ยนแปลงมาก คุณอาจพิจารณาแยกเป็นไฟล์ขนาดใหญ่ไฟล์เดียวที่มีความเสถียรมากกว่า และไฟล์เล็กกว่าหนึ่งไฟล์หรือมากกว่านั้นซึ่งเปลี่ยนแปลงบ่อยกว่า
Citar นำเสนอการจดบันทึกและการรวมการเข้าถึงที่กำหนดค่าได้ ตัวแปร citar-notes-sources กำหนดค่าแบ็กเอนด์โน้ต และ citar-notes-source จะเปิดใช้งานแบ็กเอนด์ที่คุณเลือก
แบ็คเอนด์จะระบุฟังก์ชันเป็นหลักในการอัปเดตการแสดงผล Citar เพื่อสร้างตัวเลือกที่เสร็จสมบูรณ์ และเพื่อเปิดบันทึกที่มีอยู่และบันทึกใหม่ ดูเอกสารเอกสาร citar-notes-sources สำหรับรายละเอียด และฟังก์ชันอำนวยความสะดวก citar-register-notes-source และ citar-remove-notes-source
หากคุณมีการตั้งค่า citar-library-paths ไว้ คำสั่งเปิดที่เกี่ยวข้องจะค้นหาชื่อไฟล์ของ CITEKEY.EXTENSION ในไดเร็กทอรีเหล่านั้น พวกเขายังจะแยกวิเคราะห์เนื้อหาของไฟล์ฟิลด์ ตัวแปร citar-file-parser-functions จะควบคุมว่าจะใช้ parser ตัวใด และมี parsers รวมอยู่สองตัว:
citar-file-parser-default ใช้งานได้กับรายการเส้นทางไฟล์แบบโคลอนหรือคั่นด้วยเครื่องหมายอัฒภาค เช่นเดียวกับใน Zoterocitar-file-parser-triplet ใช้งานได้กับ Mendeley และ Calibre ซึ่งแสดงไฟล์โดยใช้รูปแบบเช่น :/path/file.pdf:PDFหากคุณมีรายการที่สร้างขึ้นด้วย Zotero และ Calibre ผสมกัน คุณสามารถตั้งค่าดังกล่าวได้ จากนั้นระบบจะแยกวิเคราะห์ทั้งสองรายการ:
( setq citar-file-parser-functions
'(citar-file-parser-default
citar-file-parser-triplet)) ตัวแปร citar-library-file-extensions จะควบคุมนามสกุลไฟล์ที่คำสั่งเปิดจะรับรู้ เมื่อ 'ไม่มี' มันจะรู้จักส่วนขยายทั้งหมด ตัวแปร citar-file-additional-files-separator กำหนดรูปแบบที่ citar ควรระบุสำหรับไฟล์ไลบรารีหลายไฟล์สำหรับคีย์อ้างอิงเดียวกัน ต่อไปนี้เป็นตัวอย่างในการจดจำเฉพาะนามสกุล pdf และ jpg แต่ชื่อไฟล์เพิ่มเติมในรูปแบบ test-1.jpg :
( setq citar-library-file-extensions ( list " pdf " " jpg " )
citar-file-additional-files-separator " - " ) หากต้องการเปลี่ยนวิธีที่ citar เปิดไฟล์ด้วยนามสกุลที่กำหนด ให้ปรับแต่งตัวแปร citar-file-open-functions ที่กำหนดไว้ใน citar-file.el
เมื่อใช้ร่วมกับการเริ่มดำเนินการและให้คำปรึกษา คุณจะมีการดำเนินการทางเลือกมากมายสำหรับผู้สมัคร
สำหรับรายการ BibTeX ที่มีฟิลด์ 'crossref' Citar จะเชื่อมโยงคีย์ของรายการกับทรัพยากร (ไฟล์ บันทึกย่อ ลิงก์) ที่เกี่ยวข้องกับรายการอ้างอิงโยง
ตัวอย่างเช่น พิจารณารายการสำหรับ "Baym1965" ที่มีฟิลด์ 'crossref' "Meyers1999" เมื่อเรียก citar-open และเลือก "Baym1965" มินิบัฟเฟอร์จะแสดงรายการไฟล์ บันทึก และลิงก์ทั้งหมดที่เกี่ยวข้องกับ "Baym1965" และ "Meyers1999" คำนำหน้าที่เหมาะสม ซึ่งแสดงถึงไฟล์ บันทึกย่อ หรือลิงก์ที่เกี่ยวข้อง จะถูกแสดงรายการพร้อมกับตัวเลือกแต่ละรายการในมินิบัฟเฟอร์
หมายเหตุ: เพื่อให้คุณลักษณะ crossref ของ BibTeX ทำงานได้อย่างถูกต้อง รายการที่มีฟิลด์ 'crossref' จะต้องมา ก่อน รายการอ้างอิงโยงในไฟล์ bib (นี่เป็นข้อกำหนดของ BibTeX ไม่ใช่ของ Citar โดยเฉพาะ) ในตัวอย่างข้างต้น รายการสำหรับ "Baym1965" จะต้องมาก่อนรายการสำหรับ "Meyers1999"
คุณมีวิธีใช้ซิตาร์หลายวิธี
Citar มีตัวประมวลผล citar อ้างอิงองค์กรพร้อมความสามารถ "แทรก" "เปิดใช้งาน" และ "ติดตาม" เมื่อพูดถึง org-cite การอ้างอิง หมายถึงชุดของ การอ้างอิงตั้งแต่หนึ่งรายการขึ้นไป (citation-references) ซึ่งแต่ละรายการอาจมีข้อความที่นำหน้า (คำนำหน้า) และข้อความที่ดำเนินการต่อ (คำต่อท้าย) หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ org-cite โปรดไปที่หน้าการอ้างอิงในคู่มือองค์กร
“ตัวประมวลผลการแทรก” ใช้ citar-select-refs เพื่อเรียกดูไลบรารีของคุณเพื่อแทรกและแก้ไขการอ้างอิงและการอ้างอิงการอ้างอิงโดยใช้คำสั่ง org-cite-insert คำสั่งเป็นแบบ Context-Aware ดังนั้น ลักษณะการทำงานของคำสั่งจึงขึ้นอยู่กับตำแหน่งของจุดในการอ้างอิง ตัวอย่างเช่น ถ้าจุด:
“เปิดใช้งานโปรเซสเซอร์” รันรายการฟังก์ชั่นใน citar-org-activation-functions ซึ่งโดยค่าเริ่มต้นจะใช้ citar-org-cite-basic-activate ซึ่งเป็นเวอร์ชันของโปรเซสเซอร์ basic จาก oc-basic เพื่อให้แบบอักษรที่ใช้ประโยชน์จากประสิทธิภาพของ citar การแคช เช่นเดียวกับฟังก์ชันเล็กๆ น้อยๆ ที่เพิ่มคีย์แมป ( citar-org-citation-map ) เพื่อแก้ไขการอ้างอิง ณ จุดนั้น คีย์แมป citar-org-citation-map ประกอบด้วยการเชื่อมโยงต่อไปนี้ที่มีตัวเลือกการแก้ไขการอ้างอิงและการอ้างอิง-อ้างอิงเพิ่มเติม
| สำคัญ | ผูกพัน | คำอธิบาย |
|---|---|---|
| สำเนาถึง Cx DEL | citar-org-ลบการอ้างอิง | ลบข้อมูลอ้างอิงหรือข้อมูลอ้างอิง ณ จุดนั้น |
| สำเนาถึง Cx k | citar-org-kill-การอ้างอิง | ฆ่าการอ้างอิงหรือการอ้างอิงการอ้างอิง ณ จุดนั้น |
| S-<ซ้าย> | citar-org-shift-อ้างอิง-ซ้าย | ย้ายการอ้างอิงอ้างอิงไปทางซ้าย |
| ส-<ขวา> | citar-org-shift-อ้างอิง-ขวา | ย้ายการอ้างอิงอ้างอิงที่จุดขวา |
| MP | citar-org-update-prefix-suffix | อัปเดตคำนำหน้าและคำต่อท้ายของการอ้างอิง ณ จุดนั้น หรือ |
| เมื่อเรียกด้วยคำนำหน้า arg ให้อัปเดตทั้งหมด | ||
| การอ้างอิง-การอ้างอิงในการอ้างอิง ณ จุด | ||
| <เมาส์-1> | ซิตาร์-dwim | เรียกค่าของ citar-at-point-function ที่จุด |
| <เมาส์-3> | เริ่มดำเนินการ | เรียก embark-act ณ จุดนั้น |
“ติดตามโปรเซสเซอร์” มอบฟังก์ชันการทำงาน ณ จุดที่สามารถเข้าถึงได้ผ่านคำสั่ง org-open-at-point ตามค่าเริ่มต้น ในโหมด org พร้อมการสนับสนุน org-cite เมื่อ point อยู่บนการอ้างอิงหรือการอ้างอิงการอ้างอิง และคุณเรียกใช้ org-open-at-point มันจะรันคำสั่งที่ตั้งไว้ใน citar-at-point-function ซึ่งเป็น citar-open โดยค่าเริ่มต้น การเปลี่ยนค่าของ citar-at-point-function เป็น embark-act เมื่อติดตั้งและกำหนดค่าแล้ว จะทำให้สามารถเข้าถึงคำสั่ง citar มาตรฐาน ณ จุดนั้นได้
การอ้างอิงองค์กรรวมถึง "รูปแบบ" และ "ตัวแปร" ที่เป็นตัวเลือก เพื่อแก้ไขการแสดงผลการอ้างอิงในเครื่อง เมื่อแทรกการอ้างอิงใหม่ การเรียก org-cite-insert ด้วยคำนำหน้า arg จะแจ้งให้เลือกสไตล์ หากต้องการแก้ไขรูปแบบของการอ้างอิงที่มีอยู่ เพียงตรวจสอบให้แน่ใจว่า point อยู่ที่คำนำหน้าการอ้างอิง ก่อนที่จะรัน org-cite-insert และคุณจะได้รับรายการสไตล์ที่พร้อมใช้งาน รายการนั้นขึ้นอยู่กับการกำหนดค่าของคุณ ตัวอย่างเช่น หากคุณมีการกำหนดค่าโปรเซสเซอร์ oc-natbib และ oc-csl รายการจะรวมสไตล์และตัวแปรที่มีอยู่ในโปรเซสเซอร์ทั้งสองนั้น ตัวแปรที่รวมอยู่ในโปรเซสเซอร์ที่รวมมาให้มีดังต่อไปนี้ โดยมีทางลัดอยู่ในวงเล็บ:
bare ( b ): โดยไม่มีเครื่องหมายวรรคตอนล้อมรอบcaps ( c ): บังคับให้ใช้อักษรตัวพิมพ์ใหญ่เริ่มต้นfull ( f ): ละเว้นและย่อชื่อผู้แต่ง โดยทั่วไปแล้ว คุณไม่จำเป็นต้องใช้สิ่งเหล่านี้ แต่อาจมีประโยชน์ได้ในบางสถานการณ์ หากตัวประมวลผลการส่งออกไม่รองรับรูปแบบเฉพาะสำหรับสไตล์เฉพาะ ก็ควรเลือกใช้รูปแบบพื้นฐานแทน ตัวอย่างเช่น หากคุณระบุ text/f และตัวประมวลผลการส่งออกที่คุณใช้ไม่รองรับรูปแบบ f ตรงนั้น ระบบควรจะส่งออกเหมือนกับว่าคุณระบุ text
Mx เพียงทำ Mx และเลือกคำสั่งที่คุณต้องการ ป้อนเงื่อนไขเพื่อค้นหารายการที่คุณกำลังมองหา แล้วกด return สิ่งนี้จะเรียกใช้การกระทำเริ่มต้น: คำสั่งที่คุณเรียกใช้
embark-act หากในขณะที่เรียกดู คุณอยากจะแก้ไขเรกคอร์ดนั้นแทน และคุณได้ติดตั้งและกำหนดค่าแล้ว นี่คือจุดที่ embark-act เข้ามา เพียงป้อนคีย์ลัดสำหรับ embark-act (ในกรณีของฉัน Co ) และเลือกการดำเนินการสำรอง
embark-collect-snapshot ตัวเลือกสุดท้ายที่อาจมีประโยชน์: เรียกใช้ embark-collect-snapshot ( S ) จาก embark-act การดำเนินการนี้จะเลือกชุดย่อยที่เป็นตัวเลือก และเปิดในบัฟเฟอร์ที่แยกต่างหาก จากนั้น คุณสามารถเรียกใช้ตัวเลือกเดียวกันที่กล่าวถึงข้างต้นได้โดยใช้ embark-act (ซึ่งเชื่อมโยงกับ a ในบัฟเฟอร์การรวบรวมด้วย)
ตัวอย่างเช่น สมมติว่าคุณกำลังเขียนรายงาน คุณมีรายการ super-set ที่สมบูรณ์ซึ่งคุณสนใจที่จะอ้างอิง ณ จุดใดจุดหนึ่งในบัฟเฟอร์นั้น จากนั้น คุณสามารถดำเนินการต่างๆ กับผู้สมัครได้ตามต้องการ แทนที่จะค้นหาแต่ละรายการที่คุณต้องการอ้างอิงทีละรายการ
citar-dwim Mx citar-dwim จะดำเนินการเริ่มต้นกับคีย์การอ้างอิงที่พบในจุดโดยตรง หากคุณได้ติดตั้ง embark คุณสามารถใช้ can embark-dwim แทนสำหรับพฤติกรรมเดียวกัน และ embark-act สำหรับการดำเนินการเพิ่มเติม ณ จุดนั้น
หากไม่พบคีย์การอ้างอิง มินิบัฟเฟอร์จะเปิดขึ้นเพื่อเลือก คุณสามารถปิดการใช้งานพฤติกรรมนี้ได้โดยการตั้งค่า citar-at-point-fallback เป็นศูนย์
แพ็คเกจต่อไปนี้ขยายหรือปรับปรุงซิตาร์
แพ็คเกจขนาดเล็กเหล่านี้มีแหล่งที่มาของบันทึกย่อซิตาร์ และบูรณาการเข้ากับแพ็คเกจการจัดการบันทึกที่เกี่ยวข้องได้แนบแน่นยิ่งขึ้น
หากต้องการทำความเข้าใจว่า citar เปรียบเทียบกับแพ็คเกจอื่น ๆ เช่น org-ref , ivy-bibtex และ helm-bibtex อย่างไร (และ bibtex-completion ที่เกี่ยวข้อง) ให้ดูหน้าการเปรียบเทียบในวิกิ
แนวคิดในโครงการนี้เริ่มต้นจากการสนทนากับ Maxime Tréca และ Daniel Mendler Daniel ผู้เขียน Consult and Marginalia ช่วยให้เราเข้าใจความเป็นไปได้ของชุดแพ็คเกจอ่านจบชุดใหม่ ในขณะที่ Maxime คิดต้นแบบเบื้องต้นขึ้นมา
โค้ดนี้นำแนวคิดเหล่านั้นไปปรับใช้ใหม่เพื่อเติมเต็มชุดคุณลักษณะ และยังปรับความชัดเจนและประสิทธิภาพของโค้ดให้เหมาะสมอีกด้วย
