วิธีการเพิ่มฟอนต์แบบกำหนดเองลงใน ONLYOFFICE Document Server

เพื่อให้สามารถใช้งานแบบอักษรที่กำหนดเองใน ONLYOFFICE Docs ได้ ให้ติดตั้งไฟล์แบบอักษรลงในเครื่องหรือคอนเทนเนอร์ที่ใช้งาน Document Server สร้างรายการแบบอักษรของเซิร์ฟเวอร์ขึ้นใหม่ และตรวจสอบผลลัพธ์ในโปรแกรมแก้ไขและเอกสารที่ส่งออก ขั้นตอนการบันทึกไฟล์ที่แน่นอนจะขึ้นอยู่กับว่าเซิร์ฟเวอร์ของคุณติดตั้งโดยตรงบน Linux หรือทำงานใน Docker

การเปลี่ยนแปลงที่สำเร็จหมายความว่าแบบอักษรจะปรากฏพร้อมชื่อตระกูลในตัวเลือกแบบอักษรของโปรแกรมแก้ไข และแสดงผลได้ตามที่คาดหวังในเอกสารทดสอบ การเห็นชื่อในเมนูเป็นการตรวจสอบเบื้องต้นที่มีประโยชน์ แต่ไม่ได้พิสูจน์ว่าทุกรูปแบบ ทุกภาษา หรือทุกเส้นทางการส่งออกใช้งานได้ ตรวจสอบข้อความปกติและตัวหนา ชุดอักขระที่จำเป็น และตัวอย่าง PDF หรือตัวอย่างการพิมพ์ก่อนใช้แบบอักษรสำหรับเอกสารจริง

อะไรเปลี่ยนแปลงบ้างเมื่อคุณติดตั้งฟอนต์?

ONLYOFFICE Docs ใช้ฟอนต์ที่มีอยู่ในโฮสต์ Document Server และสร้างเมตาเดตาของฟอนต์สำหรับโปรแกรมแก้ไข คู่มือการติดตั้งของผู้จำหน่ายระบุตระกูล TrueType และ OpenType รวมถึง.ttf, .otf, .ttc, และรูปแบบที่เกี่ยวข้อง ตลอดจนรูปแบบ WOFF ประเภทไฟล์ที่รองรับไม่ได้หมายความว่าไฟล์ฟอนต์หรือคุณสมบัติฟอนต์ทุกไฟล์จะทำงานเหมือนกันทั้งหมด ควรทดสอบฟอนต์และเอกสารที่คุณวางแผนจะใช้ก่อนใช้งานจริง

การติดตั้งฟอนต์ฝั่งเซิร์ฟเวอร์ช่วยให้บรรณาธิการที่เชื่อมต่อสามารถใช้ฟอนต์ผ่าน Document Server ได้ แต่จะไม่ติดตั้งฟอนต์ลงในคอมพิวเตอร์ของผู้ใช้ทุกคนหรือบนเซิร์ฟเวอร์ประมวลผลเอกสารอื่นๆ หากไฟล์ที่ดาวน์โหลดหรือเปิดแยกต่างหากถูกดูในซอฟต์แวร์ที่ไม่มีฟอนต์นั้น ซอฟต์แวร์นั้นอาจใช้ฟอนต์อื่นแทน ONLYOFFICE ยังระบุด้วยว่า เอกสารอาจแสดงผลด้วยฟอนต์ที่ใกล้เคียงที่สุดเมื่อเซิร์ฟเวอร์ไม่มีฟอนต์ที่ใช้ในเอกสาร ซึ่งอาจส่งผลต่อการขึ้นบรรทัดใหม่หรือเค้าโครงหน้ากระดาษ

ใช้ไฟล์ฟอนต์ที่คุณได้รับอนุญาตให้ใช้งานบนเซิร์ฟเวอร์ เก็บไฟล์และข้อกำหนดใบอนุญาตไว้พร้อมกับบันทึกการใช้งาน โดยเฉพาะอย่างยิ่งหากฟอนต์นั้นมีข้อจำกัดในการใช้งานบนเซิร์ฟเวอร์ การแจกจ่ายต่อ หรือการฝังในเอกสาร

เลือกวิธีการติดตั้งที่เหมาะสม

• การติดตั้งแพ็กเกจ Linux:คัดลอกไฟล์ฟอนต์ไปยังไดเร็กทอรีฟอนต์ของระบบบนเครื่องเซิร์ฟเวอร์เอกสาร จากนั้นเรียกใช้สคริปต์สร้างฟอนต์ของ ONLYOFFICE วิธีนี้เหมาะสมเมื่อคุณจัดการโฮสต์โดยตรง
• คอนเทนเนอร์ Docker:เชื่อมต่อไดเร็กทอรีโฮสต์แบบถาวรเข้ากับไดเร็กทอรีฟอนต์ของคอนเทนเนอร์ หรือคัดลอกฟอนต์เข้าไปในคอนเทนเนอร์ที่กำลังทำงานอยู่เพื่อทดสอบในระยะเวลาสั้นๆ สร้างเมตาเดตาของฟอนต์ขึ้นใหม่ภายในคอนเทนเนอร์ การเชื่อมต่อแบบ bind mount จะคงอยู่แม้คอนเทนเนอร์จะถูกสร้างใหม่ แต่การคัดลอกฟอนต์เข้าไปในคอนเทนเนอร์เพียงครั้งเดียวโดยทั่วไปจะไม่คงอยู่
• การติดตั้งแบบจัดการหรือแบบบูรณาการ:หากแพลตฟอร์มอื่นหรือเครื่องมือติดตั้งจัดการคอนเทนเนอร์ Document Server ให้ใช้การเชื่อมต่อแบบถาวรผ่านการกำหนดค่าของการติดตั้งนั้น การแก้ไขคอนเทนเนอร์ที่กำลังทำงานอยู่เพียงอย่างเดียวอาจสูญหายไปในระหว่างการอัปเดตหรือการเปลี่ยนใหม่

คู่มือการใช้งานฟอนต์ที่ ONLYOFFICE เผยแพร่ในปัจจุบันแสดงขั้นตอนหลักที่เหมือนกันสำหรับ Community Edition บน Linux และ Docker และมีคู่มือ Linux แยกต่างหากสำหรับ Enterprise Edition เส้นทาง สิทธิ์ และการจัดการคอนเทนเนอร์อาจแตกต่างกันไปตามเวอร์ชันและวิธีการติดตั้งของคุณ ดังนั้นควรใช้การกำหนดค่าที่มีอยู่แล้วในการใช้งานของคุณแทนที่จะแทนที่ด้วยตัวอย่างจากสภาพแวดล้อมอื่น

เพิ่มฟอนต์ในการติดตั้ง Linux

1. เตรียมและติดตั้งไฟล์ฟอนต์

ดาวน์โหลดไฟล์ตระกูลฟอนต์ที่จำเป็น รวมถึงไฟล์ตัวหนาและตัวเอียงที่ถูกต้อง หากตระกูลฟอนต์นั้นมีให้ จัดเก็บตระกูลฟอนต์ทั่วไปไว้ด้วยกันในไดเร็กทอรีที่มีชื่อชัดเจน ตัวอย่างเช่น ผู้ดูแลระบบอาจจัดเก็บตระกูลฟอนต์ไว้ใน ซึ่ง/usr/share/fonts/เป็นตำแหน่งในระบบที่ใช้ในคำแนะนำสำหรับ Linux ของ ONLYOFFICE:

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

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

2. สร้างรายการฟอนต์ ONLYOFFICE ขึ้นใหม่

หลังจากติดตั้งไฟล์เสร็จแล้ว ให้เรียกใช้สคริปต์สร้างฟอนต์ของผู้จำหน่าย:

sudo /usr/bin/documentserver-generate-allfonts.sh

รอให้สคริปต์ทำงานจนเสร็จสิ้นและตรวจสอบผลลัพธ์เพื่อหาข้อผิดพลาด ขั้นตอนนี้จะอัปเดตข้อมูลฟอนต์ที่ใช้โดย Document Server การคัดลอกไฟล์ฟอนต์ไปยังโฮสต์อาจไม่ทำให้ฟอนต์ปรากฏในโปรแกรมแก้ไขที่กำลังทำงานอยู่ อย่าลบฟอนต์เซิร์ฟเวอร์ที่มีอยู่แล้วในขั้นตอนนี้ ผู้จำหน่ายเตือนว่าการลบฟอนต์ระบบอาจส่งผลต่อเค้าโครงและการแสดงผลของเอกสาร

เพิ่มฟอนต์ลงในการใช้งาน Docker

1. ตั้งค่าให้ไดเร็กทอรีฟอนต์คงอยู่ถาวร

สำหรับการใช้งานที่จัดการด้วย Docker Compose ให้เพิ่ม bind mount ไปยังบริการ Document Server ที่มีอยู่ สร้างไดเร็กทอรีโฮสต์สำหรับไฟล์ จากนั้นแมปไปยังไดเร็กทอรี custom-font ของคอนเทนเนอร์ อิมเมจ Docker ของ ONLYOFFICE ประกาศ/usr/share/fonts/truetype/customเป็น volume และคำแนะนำเกี่ยวกับฟอนต์ของ Docker ยังอนุญาตให้คัดลอกฟอนต์ภายใต้/usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

นี่เป็นเพียงส่วนหนึ่งที่จะนำไปผสานรวมกับไฟล์ Compose ปัจจุบันของคุณ ไม่ใช่การกำหนดค่าทดแทนทั้งหมด โปรดคงเวอร์ชันรูปภาพ เครือข่าย ตัวแปรสภาพแวดล้อม ปริมาณข้อมูล ข้อมูลลับ และชื่อบริการที่มีอยู่เดิมไว้ เตรียมไฟล์ฟอนต์บนโฮสต์/srv/onlyoffice/fontsและตรวจสอบให้แน่ใจว่าคอนเทนเนอร์สามารถอ่านไฟล์เหล่านั้นได้

การแก้ไขไฟล์ Compose อาจทำให้คอนเทนเนอร์ Document Server สร้างใหม่และอาจขัดจังหวะเซสชันการแก้ไขที่ใช้งานอยู่ ตรวจสอบขั้นตอนการติดตั้งใช้งาน สำรองข้อมูลการกำหนดค่า Compose และกำหนดเวลาการเปลี่ยนแปลงให้เหมาะสม หากคอนเทนเนอร์ได้รับการจัดการโดยอุปกรณ์หรือการผสานรวม ให้ใช้วิธีการกำหนดค่าที่รองรับแทนการแก้ไขไฟล์ Compose ที่สร้างขึ้น

2. สร้างใหม่หรือรีสตาร์ท จากนั้นสร้างข้อมูลเมตาของฟอนต์

ใช้เวิร์กโฟลว์ Compose ปกติสำหรับการปรับใช้ของคุณเพื่อทำการติดตั้ง จากนั้นเรียกใช้สคริปต์สร้างฟอนต์ภายในคอนเทนเนอร์ Document Server จริง สำหรับคอนเทนเนอร์ชื่อonlyoffice-documentserverคำสั่งคือ:

docker exec onlyoffice-documentserver   /usr/bin/documentserver-generate-allfonts.sh

ใช้ชื่อหรือ ID ของคอนเทนเนอร์ที่แสดงโดยdocker ps. หากคุณต้องการตรวจสอบฟอนต์ก่อนที่จะตั้งค่าอย่างถาวร เอกสารของผู้จำหน่ายระบุวิธีการคัดลอกไฟล์ฟอนต์ลงในคอนเทนเนอร์ที่กำลังทำงานอยู่โดยdocker cpใช้ ตามด้วยการเรียกใช้สคริปต์เดียวกันภายในคอนเทนเนอร์นั้น ให้ถือว่านี่เป็นการทดสอบ: ไฟล์ที่คัดลอกลงในคอนเทนเนอร์อาจหายไปเมื่อเปลี่ยนคอนเทนเนอร์

ตรวจสอบแบบอักษรในโปรแกรมแก้ไขข้อความและในผลลัพธ์

1. เปิดเอกสารในโปรแกรมแก้ไขข้อความที่เชื่อมต่อกับเซิร์ฟเวอร์เอกสารนี้ แล้วเปิดตัวเลือกแบบอักษร ค้นหาชื่อตระกูลแบบอักษรตามที่บันทึกไว้ในข้อมูลเมตาของแบบอักษรนั้น
2. สร้างเอกสารทดสอบขนาดสั้นที่มีข้อความธรรมดา ข้อความตัวหนา และตัวอักษรจากภาษาที่คุณต้องการ ตรวจสอบให้แน่ใจว่าได้เลือกน้ำหนักตัวอักษรที่ถูกต้องแล้ว ไม่ใช่การเลือกสไตล์ที่สร้างขึ้นเองหรือสไตล์ที่ถูกแทนที่
3. บันทึก เปิดใหม่ และส่งออก หรือดูตัวอย่างก่อนพิมพ์เอกสารทดสอบ เปรียบเทียบการขึ้นบรรทัดใหม่ จำนวนหน้า ระยะห่าง และความครอบคลุมของตัวอักษรกับผลลัพธ์ที่คาดหวัง
4. ตรวจสอบซ้ำอีกครั้งในโปรแกรมแก้ไขเอกสารหรือแอปพลิเคชันที่ผู้ใช้ของคุณใช้งานจริง ฟอนต์ที่มีอยู่ในเซิร์ฟเวอร์ไม่ได้หมายความว่าแอปพลิเคชันในเครื่องที่ไม่เกี่ยวข้องหรือเซิร์ฟเวอร์อื่นจะมีฟอนต์นั้นด้วย

สำหรับโปรแกรมเวอร์ชันเก่า ข้อมูลเมตาของฟอนต์ที่แคชไว้ในเบราว์เซอร์อาจทำให้การแสดงผลล่าช้า คู่มือที่เผยแพร่โดย ONLYOFFICE ระบุว่าสำหรับเวอร์ชัน 8.1.3 หรือก่อนหน้า ให้ล้างแคชของเบราว์เซอร์และเปิดหน้าเว็บใหม่อีกครั้งหลังจากเพิ่มฟอนต์แล้ว สำหรับเวอร์ชันที่ใหม่กว่า ขั้นตอนนี้ไม่จำเป็น ตรวจสอบไฟล์ฝั่งเซิร์ฟเวอร์และข้อมูลเมตาที่สร้างขึ้นก่อน จากนั้นใช้คำแนะนำเกี่ยวกับการแคชเฉพาะเมื่อตรงกับเวอร์ชันของคุณเท่านั้น

หากไม่พบแบบอักษรหรือมีการเปลี่ยนแปลงรูปแบบ

• ไม่พบฟอนต์ในตัวเลือก:ตรวจสอบให้แน่ใจว่าไฟล์อยู่ในไดเร็กทอรีฟอนต์บนโฮสต์เซิร์ฟเวอร์เอกสารหรือภายในคอนเทนเนอร์ที่ถูกต้อง สามารถอ่านได้ และมีประเภทไฟล์ที่รองรับ เรียกใช้สคริปต์สร้างฟอนต์อีกครั้งและอ่านผลลัพธ์ ใน Docker ให้ตรวจสอบการเมานต์จากภายในคอนเทนเนอร์ เส้นทางโฮสต์เพียงอย่างเดียวไม่สามารถพิสูจน์ได้ว่าวอลุ่มเชื่อมต่อกับบริการที่ใช้งานอยู่
• ชื่อตระกูลฟอนต์อาจดูแตกต่างกัน:โปรดตรวจสอบข้อมูลเมตาของตระกูลฟอนต์ที่ฝังอยู่ภายใน ไฟล์ที่มีชื่อเช่นBrandSans-Bold.ttfอาจติดตั้งได้อย่างถูกต้อง ในขณะที่เมนูแสดงชื่อตระกูลที่กำหนดไว้ภายในฟอนต์
• แบบอักษรปรากฏขึ้น แต่ข้อความไม่ถูกต้อง:ตรวจสอบว่าแบบอักษรนั้นมีอักขระที่จำเป็นและไฟล์สไตล์ที่ถูกต้องหรือไม่ แบบอักษรอาจปรากฏในตัวเลือก แต่ขาดสัญลักษณ์หรือน้ำหนักที่ใช้ในเอกสาร
• เอกสารอาจมีการจัดเรียงใหม่หลังจากการเปลี่ยนแปลง:เปรียบเทียบตระกูลและรูปแบบตัวอักษรที่ใช้ก่อนและหลังการเปลี่ยนแปลง หากตัวอักษรต้นฉบับหายไปในเครื่องอื่นหรือบริการส่งออก ตัวอักษรทดแทนอาจเปลี่ยนเค้าโครงได้ ติดตั้งตัวอักษรที่ได้รับอนุญาตในทุกที่ที่มีการแสดงผล หรือใช้ตัวอักษรทางเลือกที่ปลอดภัยสำหรับเอกสาร และตรวจสอบหน้าเว็บอีกครั้ง
• ฟอนต์หายไปหลังจากการอัปเดต:ตรวจสอบว่าการติดตั้งทำภายในคอนเทนเนอร์แบบใช้แล้วทิ้งหรือไม่ ย้ายไฟล์ไปยังไดเร็กทอรีโฮสต์ถาวรและแนบผ่านการกำหนดค่าการปรับใช้ก่อนที่จะสร้างบริการใหม่

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

เอกสารอ้างอิงอย่างเป็นทางการ

• ONLYOFFICE Docs Community Edition: การเพิ่มฟอนต์บน Linux
• ONLYOFFICE Docs Community Edition: การเพิ่มฟอนต์บน Docker
• ONLYOFFICE Docs Enterprise Edition: การเพิ่มฟอนต์บน Linux
• ที่เก็บเอกสาร Docker-DocumentServer ของ ONLYOFFICE