mirador

โปรเจ็กต์นี้มีไว้สำหรับ Mirador 3 ซึ่งเป็นเวอร์ชันล่าสุดของ Mirador สำหรับ Mirador 2 โปรดดู ProjectMirador/mirador2 หรือเอกสารประกอบดั้งเดิมในวิกิ Mirador 2 โปรดทราบว่าชุมชนมุ่งเน้นไปที่ Mirador 3 และไม่น่าจะยอมรับคำขอดึงข้อมูลหรือให้การสนับสนุน Mirador 2

มิราดอร์

สำหรับผู้ใช้ Mirador

คุณสามารถใช้และกำหนดค่า Mirador ได้อย่างรวดเร็วโดยรีมิกซ์ Glitch ที่เริ่มด้วย Mirador

เราขอแนะนำให้ติดตั้ง Mirador โดยใช้ตัวจัดการแพ็คเกจ JavaScript เช่น npm หรือเส้นด้าย

$ npm install mirador 

# or

$ yarn add mirador

หากคุณสนใจที่จะรวม Mirador กับปลั๊กอินเข้ากับโปรเจ็กต์ของคุณ เราขอแนะนำให้ใช้ webpack หรือพัสดุเพื่อรวมแพ็คเกจเวอร์ชัน es ตัวอย่างอยู่ที่นี่:

https://github.com/ProjectMirador/mirador-integration

หากคุณต้องการฝัง Mirador ในหน้า HTML โดยไม่ต้องปรับแต่งเพิ่มเติม ให้รวม Mirador UMD build:

 <script src="https://unpkg.com/mirador@latest/dist/mirador.min.js"></script>

ตัวอย่างเพิ่มเติมของการฝัง Mirador สามารถดูได้ที่ https://github.com/ProjectMirador/mirador/wiki/M3-Embedding-in-Another-Environment#in-an-html-document-with-javascript

การเพิ่มคำแปลใน Mirador

หากต้องการความช่วยเหลือในการเพิ่มการแปล โปรดดูที่ src/locales/README.md

ใช้ Mirador ในพื้นที่เพื่อการพัฒนา

การพัฒนาท้องถิ่นของ Mirador จำเป็นต้องติดตั้ง nodejs

1. รัน npm install เพื่อติดตั้งการขึ้นต่อกัน

เริ่มโครงการ

$ npm start

จากนั้นไปที่ http://127.0.0.1:4444/

การสร้าง Mirador ขึ้นมาทันที

 var miradorInstance = Mirador . viewer ( {
  id : 'mirador' // id selector where Mirador should be instantiated
} ) ;

> miradorInstance
{ actions , store }

ตัวอย่างการกระทำ

เพิ่มหน้าต่าง:

 store . dispatch ( actions . addWindow ( ) ) ;

หากต้องการโฟกัสการรันหน้าต่าง:

 store . dispatch ( actions . focusWindow ( 'window-1' ) )

ตรวจสอบสถานะปัจจุบัน

 store . getState ( ) 

ดำเนินการทดสอบ

$ npm test # For headless CI=true npm test

หรือดูไฟล์ต้นฉบับอย่างต่อเนื่อง

$ npm run test:watch

กำลังสานโครงการ

$ npm run lint

การดีบัก

อินสแตนซ์ท้องถิ่น

ส่วนขยายเบราว์เซอร์ต่อไปนี้มีประโยชน์สำหรับการดีบักอินสแตนซ์การพัฒนาในเครื่องของ Mirador:

• โต้ตอบ DevTools
• Redux DevTools

ชุดทดสอบ

หากต้องการดีบักชุดทดสอบ ให้รัน:

$ npm run test:debug

จากนั้นหมุนไคลเอ็นต์ตัวตรวจสอบ nodejs และตั้งค่าเบรกพอยต์ ดูคำแนะนำในการแก้ไขข้อบกพร่องด้วย Chrome DevTools ที่นี่