zot_bib_web

บรรณานุกรมเว็บแบบอินเทอร์แอคทีฟกับ Zotero

การติดตั้งตัวอย่าง

เว็บไซต์แล็บที่ Penn State

เว็บไซต์ส่วนตัว

เอกสาร

http://zot-bib-web.readthedocs.io/

ผู้แต่ง/ติดต่อ:

David [email protected] http://www.david-reitter.com

คุณสมบัติ

เครื่องมือนี้สร้างบรรณานุกรมเว็บแบบอินเทอร์แอคทีฟโดยใช้คอลเลกชันอย่างน้อยหนึ่งรายการในที่เก็บ Zotero คอลเลกชันสามารถรักษาได้โดยกลุ่มคนโดยใช้เว็บอินเตอร์เฟสของ Zotero หรือแอปพลิเคชันเดสก์ท็อปของพวกเขา

บรรณานุกรมสามารถสั่งซื้อได้โดยการรวบรวมโดยปีที่ตีพิมพ์หรือตามประเภทสิ่งพิมพ์ (เช่นบทความวารสารก่อน) สามารถค้นหาได้แบบโต้ตอบสามารถเชื่อมโยงกับเอกสาร PDF หรือ URL อื่น ๆ มีบันทึกสำหรับ bibtex, endnote และ wikipedia และสามารถส่งออกไปยัง HTML

zot_bib_web ไม่ได้ขึ้นอยู่กับเว็บเซิร์ฟเวอร์บุคคลที่สามใด ๆ บรรณานุกรมที่สร้างขึ้นโหลดได้อย่างรวดเร็วเนื่องจากถูกเก็บไว้เป็นไฟล์คงที่พร้อมกับส่วนที่เหลือของเว็บไซต์ของคุณ สิ่งนี้ทำให้เป็นแหล่งที่ดีสำหรับ webcrawlers รวมถึง Google Scholar และ Citeseer

การตั้งค่าเป็นเรื่องง่ายสำหรับทุกคนที่ใช้งานเว็บไซต์ของตัวเองและรู้วิธีใช้บรรทัดคำสั่ง (เชลล์) วิธีที่ง่ายที่สุดในการใช้คือเรียก zot.py ด้วยกุญแจของคอลเลกชันสาธารณะ zotero มันจะทำให้ไฟล์ zotero-bib.html คัดลอกสิ่งนี้พร้อมกับไดเรกทอรี "ไซต์" และ "ไฟล์" (ถ้ามี) ไปยังเว็บเซิร์ฟเวอร์ของคุณ

การสาธิต

• ดูไฟล์ HTML ในโฟลเดอร์สาธิตสำหรับตัวอย่างของบรรณานุกรม ไฟล์การตั้งค่าที่เกี่ยวข้องและไฟล์สไตล์ CSS รวมอยู่ด้วย

• วิ่ง:

   ./zot.py -การตั้งค่าการตั้งค่า/การตั้งค่า 3.py
  

  เพื่อดูการกระทำ

ใบอนุญาตและการบริจาค

• ใช้และแก้ไขซอฟต์แวร์นี้โดยไม่เสียค่าใช้จ่าย
• ไม่มีการรับประกันใด ๆ
• โปรดส่งอีเมล [email protected] ลิงก์ไปยังบรรณานุกรมบนเว็บไซต์ของคุณหากคุณตัดสินใจใช้ zot_bib_web
• คุณสามารถใช้ซอฟต์แวร์นี้ได้ฟรี

ความต้องการ

• Python 2.7 หรือ 3.6+

• Pyzotero ในการติดตั้ง Pyzotero ไลบรารีสำหรับ Python:

   sudo pip ติดตั้ง pyzotero
  

  หรือ:

   sudo easy_install pyzotero
  

• คอลเลกชัน Zotero พร้อมบรรณานุกรมของคุณ (เป็นผู้ใช้หรือเป็นกลุ่ม)

• ตัวเลือก: แพ็คเกจ DateUtils สำหรับ Python (ปรับปรุงการแยกวิเคราะห์วันที่ถ้ามี)

การตั้งค่า

• ตรวจสอบให้แน่ใจว่า zot.py สามารถเรียกใช้งานได้ (chmod ug+x zot.py)

• ลองดู จากบรรทัดคำสั่งแบบ UNIX ทำสิ่งนี้:

   ./zot.py -กลุ่ม 160464 dtdtv2ep
  

จากนั้นดู zotero-bib.html ในเบราว์เซอร์ หากดูดีให้ไปยังขั้นตอนถัดไปสำหรับการกำหนดค่า

• ในไฟล์ใหม่ที่เรียกว่า settings.py เพิ่มการกำหนดค่าตามที่บันทึกไว้ในไฟล์ settings_example.py ไปที่ zotero.org เพื่อรับรหัสลับ API ของคุณและผู้ใช้หรือรหัสห้องสมุดของคุณ เป็นเรื่องง่าย: ดูด้านบนของการตั้งค่าตัวอย่างตัวอย่าง หากตั้งค่าการตั้งค่า py คุณสามารถโทรหา zot.py ได้โดยไม่ต้องอาร์กิวเมนต์

หรือคุณสามารถใช้การตั้งค่าหลักในอาร์กิวเมนต์ไปยังโปรแกรม

บรรณานุกรมใน Zotero

• ด้วย Zotero สร้างบรรณานุกรมและจดบันทึก ID (เช่นจาก URL ใน Zotero Web Interface) ตัวอย่าง: MGID90AT ID นี้เป็นสิ่งที่คุณต้องการสำหรับตัวแปร "toplevelfilter" ในการตั้งค่า py
• คุณสามารถเพิ่มการสะสมย่อยในบรรณานุกรมของคุณ
• หากคุณจัดรูปแบบการสั่งซื้อโดยคอลเลกชันการสั่งซื้ออาจเป็นประโยชน์ คุณสามารถตั้งชื่อคอลเลกชันเริ่มต้นด้วยตัวเลข: "10 จิตวิทยาสังคม"

นี่คือตัวอย่างของโครงสร้างบรรณานุกรม:

 สิ่งพิมพ์ของฉัน [MGID90AT]
    10 ผลงานที่เลือก
    15 ในการเตรียมการ / ระหว่างการตรวจสอบ
    20 ผลงานผู้ตัดสินตามหัวข้อ
        ความหมาย
        การแยกวิเคราะห์
        บทสนทนา
        การเรียนรู้ของเครื่องจักร
    30 วิทยานิพนธ์
    40 พูดคุย (ไม่มีกระดาษ)

หากต้องการดูสิ่งนี้ให้ใช้การตั้งค่าที่ให้มาเป็นตัวอย่าง

ภาพรวมของตัวเลือกการกำหนดค่า

• การกำหนดค่าเกิดขึ้นในไฟล์การตั้งค่าโดยค่าเริ่มต้นชื่อ settings.py
• โทร./zot.py-help เพื่อดูรายการตัวเลือกบรรทัดคำสั่ง
• โปรดดูเอกสารสำหรับข้อมูลเกี่ยวกับไฟล์การตั้งค่าหรืออ่าน settings_example.py มีการกล่าวถึงตัวเลือกเล็กน้อยในเรื่องต่อไปนี้
• คุณสามารถสั่งซื้อบรรณานุกรมของเราโดยการรวบรวมย่อยตามปีหรือตามประเภทสิ่งพิมพ์ (เช่นบทความวารสารก่อนจากนั้นเอกสารการประชุม) แม้ในหมวดหมู่ระดับสูงกว่าคุณสามารถจัดเรียงรายการบรรณานุกรมของคุณตามที่คุณต้องการ ใช้การตั้งค่า "sort_criteria" และ "show_top_section_headings"
• คุณสามารถเลือกการจัดรูปแบบการจัดรูปแบบที่แตกต่างกัน ค่าเริ่มต้นคือรูปแบบ APA
• ที่ด้านบนกล่องค้นหาและชุดทางลัดอาจปรากฏขึ้นตัวอย่างเช่นหลายปีหรือช่วงเวลาหลายปีประเภทสิ่งพิมพ์หรือการรวบรวมย่อยที่ระบุพื้นที่หัวข้อ ผู้เข้าชมอาจคลิกที่สิ่งเหล่านี้เพื่อกรองบรรณานุกรมอย่างรวดเร็ว
• กำหนดค่าทางลัดที่แสดงที่ด้านบนโดยใช้ตัวแปร show_shortcuts 'คอลเลกชัน', 'ประเภท', 'ปี', 'สถานที่', 'venue_short' และ 'แท็ก' เป็นค่าที่รองรับนอกเหนือจากรายการค่าที่ดีมากขึ้นคุณสามารถสร้างโดยใช้ฟังก์ชันทางลัด () คุณสามารถให้รายการค่าหรือช่วง (เป็นเวลาหลายปี) คำสั่งซื้อของพวกเขาและการกรองบางอย่างเพื่อแสดงเฉพาะสิ่งที่พบบ่อยที่สุด ดู settings.example.py สำหรับตัวอย่างโดยละเอียด
• มีตัวเลือกอีกหลายตัวเลือก อีกครั้งดู settings_example.py

การปรับใช้กับเว็บไซต์

• อัปโหลดโฟลเดอร์ไซต์หรือเนื้อหาไปยังสถานที่สาธารณะบนเว็บเซิร์ฟเวอร์ของคุณ โดยค่าเริ่มต้น /ไซต์ /... เป็น URL ที่สันนิษฐาน

เพื่อสร้าง HTML และรวมไว้ในเว็บไซต์:

• เรียกใช้ zot.py หนึ่งครั้ง/ตามความต้องการหรือติดตั้งเป็นงาน cron หรือบริการบนเซิร์ฟเวอร์ไม่เรียกใช้มากกว่าวันละครั้ง กำหนดค่าโดยตรงใน zot.py หรือในการตั้งค่าไฟล์แยกต่างหาก py เพื่อสร้างการอัพเกรดง่าย ๆ
• รวมไฟล์ผลลัพธ์ zotero-bib.html (หรือตามที่กำหนดค่า) ในเว็บไซต์ของคุณตามที่คุณเห็น FIT คุณอาจรวมไฟล์คอลเลกชันแต่ละไฟล์ซึ่งสร้างขึ้นด้วย คุณสามารถกำหนดค่า zot.py เพื่อสร้างเอกสาร HTML ที่สมบูรณ์หรือเพียงส่วนหนึ่งของมัน ZOT_BIB_WEB สร้างเนื้อหา HTML5
• จัดสไตล์บรรณานุกรมของคุณโดยใช้ CSS รวมไฟล์สไตล์ตัวอย่าง (ดูไซต์/ ไดเรกทอรี)

การสนับสนุน WordPress

แพ็คเกจนี้สามารถผลักดันโดยตรงไปยังไซต์ WordPress โปรแกรมแยกต่างหาก "push.py" รวมอยู่ในสิ่งนี้

ทำตามขั้นตอนเหล่านี้:

1. ตั้งค่า zot.py เพื่อสร้างบรรณานุกรมที่คุณชอบ CALL ZOT.PY-FULL เพื่อสร้างไฟล์ zotero-bib.html ที่สมบูรณ์เพื่อวัตถุประสงค์ในการดีบัก กำหนดค่าการตั้งค่า py เพื่อไม่สร้างรหัส HTML แบบเต็ม
2. ติดตั้งปลั๊กอิน WPAUTOP-Control (หรือปลั๊กอินที่คล้ายกัน) เพื่อให้แน่ใจว่า WP จะไม่แทรกวรรคแบ่งในสถานที่ต่าง ๆ ในบรรณานุกรม ด้วยปลั๊กอินนี้คุณจะต้องเพิ่ม "ฟิลด์ที่กำหนดเอง" ลงในหน้าเว็บที่สร้างขึ้นในขั้นตอนถัดไป (เลือก "ตัวเลือกหน้าจอ" ที่ด้านบนของมุมมองหน้าเปิดใช้งานฟิลด์ที่กำหนดเองจากนั้นค้นหาฟิลด์ที่กำหนดเองที่ด้านล่างสุดของหน้าและเพิ่มฟิลด์ "wpautop" ที่มีค่า "ไม่"
3. สร้างหน้า WP หรือโพสต์สำหรับบรรณานุกรม แทรก [zot_bib_web collection] ที่คุณต้องการที่จะแทรกบรรณานุกรม แทนที่คอลเลกชันด้วย ID ของคอลเลกชัน (ตัวเลือกเพิ่มเติม: ดู push.py)
4. คัดลอกเนื้อหาชีทสไตล์ (ในไซต์/) ไปยังธีม WordPress ของคุณ (เลือก "Editor" หรือ "CSS เพิ่มเติม")
5. กำหนดค่าการตั้งค่า py เพื่อให้ jQuery และไฟล์อื่น ๆ มีอยู่บนเว็บเซิร์ฟเวอร์ โดยทั่วไปแล้วนี่จะเป็น jQuery_path = "../wp-includes/js/jquery/jquery.js" clipboard.js และ clippy.svg: คุณอาจอ้างถึง URL สาธารณะหรือเสิร์ฟไฟล์ด้วยตัวเอง
6. กำหนดค่า push.py (ที่ด้านบน) คุณจะต้องทราบรายละเอียดง่ายๆเกี่ยวกับการติดตั้ง WP ของคุณ
7. เรียกใช้ push.py เป็นประจำหรือตามความต้องการ มันจะเรียก zot.py โดยอัตโนมัติจากนั้นอัปเดตหน้าใน WP