ที่เก็บนี้มีโค้ดสำหรับ Zotero Bib รวมถึงส่วนประกอบ React, ไคลเอนต์การแปล, สไตล์ชีต และเว็บไซต์เริ่มต้น
การเดินทางห้องสมุด
git clone --recursive [email protected]:zotero/zoterobib.git
cd zoterobib
npm install
npm start
ซึ่งจะให้บริการการสาธิตบน http://127.0.0.1:8001
คุณอาจต้องระบุตัวเลือกการกำหนดค่า (ดูด้านล่าง) เพื่อให้พื้นที่เก็บข้อมูลและการแปลทำงานได้
ตามค่าเริ่มต้น พร็อกซีเซิร์ฟเวอร์การพัฒนาจะร้องขอเซิร์ฟเวอร์การแปลไปยัง localhost:1969 หากเซิร์ฟเวอร์ของคุณอยู่ที่อื่น คุณจะต้องระบุ URL เช่น ขั้นตอนสุดท้ายข้างต้นจะมีลักษณะดังนี้:
TRANSLATE_URL=http://localhost:1234 npm start
นี่จะเป็นการร้องขอพร็อกซีจากเบราว์เซอร์ไปยังเซิร์ฟเวอร์การแปลที่ระบุ
หากต้องการรับไฟล์ที่พร้อมใช้งานจริงให้ใช้คำสั่ง npm ต่อไปนี้:
npm run build
คุณสามารถจัดเตรียมพารามิเตอร์การกำหนดค่าสำหรับบิลด์ (ทั้งในการพัฒนาและการใช้งานจริง) โดยใช้ไฟล์การกำหนดค่าและ/หรือตัวแปรสภาพแวดล้อม
วิธีที่ง่ายที่สุดคือการคัดลอก config/default.json
ไปยัง config/local.json
และวางตัวแปรไว้ที่นั่น (ไฟล์นี้จะถูกละเว้น git และไม่ควรคอมมิต) หรือจะใช้ตัวแปรสภาพแวดล้อมที่แสดงอยู่ใน config/custom-environment-variables.json
ก็ได้ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการกำหนดค่า โปรดดูที่แพ็คเกจ config npm
ยอมรับตัวเลือกการกำหนดค่าต่อไปนี้:
storeURL ระบุ URL สำหรับ Bib-Server API ที่เก็บบรรณานุกรม
stylesURL ระบุ URL สำหรับเว็บไซต์ styles-repo เมื่อเว้นว่างไว้ ระบบจะใช้ค่าเริ่มต้นซึ่งก็คือ https://www.zotero.org/styles-files/styles.json
TranslatePrefix ระบุคำนำหน้าเพิ่มเติมสำหรับตำแหน่งที่ควรส่งคำขอเซิร์ฟเวอร์การแปล มีประโยชน์ในกรณีที่ translateURL
เว้นว่างไว้เพื่อให้สามารถส่งคำขอโดยตรงไปยังปลายทางเฉพาะที่ใดก็ตามที่โฮสต์ zotero-bib
TranslateURL ระบุ URL สำหรับ เซิร์ฟเวอร์การแปล โดยค่าเริ่มต้น localhost จะถือว่าเป็นคำขอพร็อกซีไปยังเซิร์ฟเวอร์การแปล
apiAuthorityPart ระบุส่วนที่ได้รับอนุญาตของ URL สำหรับคำขอ Zotero API ค่าเริ่มต้นเป็น api.zotero.org
การรัน npm start
จะตรวจสอบตัวแปรสภาพแวดล้อมต่อไปนี้:
TRANSLATE_URL ตำแหน่งที่จะร้องขอการแปลพร็อกซี ค่าเริ่มต้นเป็น http://localhost:1969 ตามค่าเริ่มต้น ZoteroBib จะส่งคำขอการแปลไปที่ window.location.origin
และเซิร์ฟเวอร์ dev ควรได้รับการกำหนดค่าให้พร็อกซีคำขอเหล่านี้ไปยังเซิร์ฟเวอร์การแปล
PORT พอร์ตใดที่เซิร์ฟเวอร์ dev ควรรับฟัง มีค่าเริ่มต้นเป็น 8001
NO_HYDRATE เมื่อเข้าถึงบรรณานุกรมระยะไกล ZoteroBib สามารถไฮเดรตจาก HTML ที่แสดงผลล่วงหน้าเพื่อหลีกเลี่ยงการหมุนวนขณะโหลด เพื่อวัตถุประสงค์ในการพัฒนา บรรณานุกรมแบบฮาร์ดโค้ดจะถูกจัดเก็บไว้ใน hydrate.hbs
และใช้เพื่อตอบสนองคำขอใดๆ ที่มี ID บรรณานุกรมระยะไกล หากต้องการปิดใช้งานพฤติกรรมนี้ ให้ตั้งค่า NO_HYDRATE
เป็น 1
ซึ่งจะให้บริการ index.hbs
แทน ซึ่งหมายความว่าบรรณานุกรมจะแสดงผลฝั่งไคลเอ็นต์ด้วยสปินเนอร์เสมอ