หน้าแรก>แหล่งข้อมูลการสร้างเว็บไซต์>ดาวน์โหลดแบบอักษร
ดาวน์โหลด

ข้อมูลจำเพาะเวอร์ชันตัวอักษรเปิด

ข้อมูลจำเพาะเวอร์ชันตัวอักษรเปิด

เวอร์ชัน 0.3.0

สถานะ: การทดลองร่างที่ไม่เสถียร

สารบัญ

  • บทนำและเหตุผล
  • คำจำกัดความ
  • ข้อกำหนด OpenFV
    • ชื่อตารางชื่อ 5 ข้อมูลจำเพาะบันทึก
    • สเปคบันทึกการบันทึก FONTREVISION
    • ความหมายหมายเลขหมายเลข
  • ตัวอย่าง
    • ชื่อตารางชื่อ 5 ตัวอย่างบันทึก
    • ตัวอย่างบันทึกการบันทึก FONTREVISION
  • ใบอนุญาต

บทนำและเหตุผล

สตริงเวอร์ชันซอฟต์แวร์โดยทั่วไปรวมถึงความหมายต่อไปนี้:

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

วิธี SEMVER ที่จัดตั้งขึ้นและใช้กันอย่างแพร่หลายในการกำหนดเวอร์ชันซอฟต์แวร์ความหมายใช้รูปแบบหมายเลขรุ่น MAJOR.MINOR.PATCH พร้อมมาตรฐานซอฟต์แวร์ API สำหรับค่าที่เพิ่มขึ้นในระหว่างกระบวนการพัฒนาซอฟต์แวร์ ข้อมูลเมตาเพิ่มเติมมักจะผนวกเข้ากับไวยากรณ์ SEMVER นี้เพื่อระบุความพร้อมของซอฟต์แวร์สำหรับการใช้งานทั่วไปโดยผู้ใช้ปลายทางเมื่อการทำงานดำเนินไปสู่เหตุการณ์สำคัญ (เช่น v1.2.0-alpha , v1.2.0-beta , v1.2.0-rc.1 , v1.2.0 v1.2.0-rc.2 , v1.2.0 ) โครงการที่สร้างสิ่งประดิษฐ์ไบนารีที่รวบรวมจากซอร์สโค้ดมักจะเชื่อมโยงฉลากเข้ากับสิ่งประดิษฐ์สร้างเพื่อสร้างบันทึกสถานะของซอร์สโค้ดในเวลาที่สร้าง (เช่น Git commit sha1 แฮชสตริง)

แนวคิดการกำหนดเวอร์ชันเหล่านี้ใช้กับการพัฒนาซอฟต์แวร์แบบอักษรและเป็นที่ต้องการในระหว่างกระบวนการพัฒนา อย่างไรก็ตามพวกเขาไม่ได้กำหนดทั้งหมดภายใต้ข้อกำหนดการกำหนดเวอร์ชันแบบอักษร Opentype สตริงเวอร์ชันซอฟต์แวร์แบบ TypeFace ถูกรวบรวมไว้ใน NameID 5 Record ของตารางชื่อ Opentype และบันทึก Fontrevision ของตารางหัว Opentype ระเบียนเหล่านี้ถูกกำหนดไว้ในข้อกำหนดของรูปแบบ opentype ดังต่อไปนี้และอธิบายในเอกสารแนวทางปฏิบัติที่ดีที่สุดในการพัฒนา SIL Font (แหล่งที่มา)

Opentype ชื่อตาราง ID 5 การบันทึกคำจำกัดความ

สตริงเวอร์ชัน ควรเริ่มต้นด้วยเวอร์ชัน 'ไวยากรณ์' (ตัวพิมพ์เล็กตัวพิมพ์เล็กหรือผสมกับช่องว่างระหว่าง "เวอร์ชัน" และจำนวน)

สตริงจะต้องมีหมายเลขเวอร์ชันของแบบฟอร์มต่อไปนี้: หนึ่งหลักหรือมากกว่า (0-9) ของค่าน้อยกว่า 65,535 ตามด้วยระยะเวลาตามด้วยตัวเลขหนึ่งตัวหรือมากกว่าของค่าน้อยกว่า 65,535 อักขระใด ๆ ที่ไม่ใช่ตัวเลขจะยุติจำนวนเล็กน้อย ตัวละครเช่น“;” เป็นประโยชน์ในการแยกข้อมูลเวอร์ชันที่แตกต่างกัน

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

(แหล่งที่มา)

Opentype Head Table Fontrevision Record

กำหนดโดยผู้ผลิตแบบอักษร

(แหล่งที่มา)

ข้อมูลจำเพาะ Opentype กำหนดหมายเลขเวอร์ชันเป็น MAJOR.MINOR ไม่มีข้อกำหนดสำหรับหมายเลขเวอร์ชันแพ PATCH / BUILD หรือหมายเลขเวอร์ชันเมตาดาต้า การกำหนดเวอร์ชันแบบอักษรเบี่ยงเบนไปจากรูปแบบหมายเลขเวอร์ชัน SEMVER ซึ่งเป็นผลมาจากการประชุม Font Compiler เพื่อรวม Zero Padding ในหมายเลขรุ่นรอง MINOR แม้ว่านี่จะไม่ใช่กรณีใน NameId 5 Records แต่นี่เป็นรูปแบบที่สอดคล้องกันที่ใช้ใน head.fontrevision Record การตีความหมายเลขเวอร์ชันด้วยวิธีการนี้ไม่ได้ใช้งานง่าย สตริงหมายเลขเวอร์ชัน Version 1.1 , Version 1.01 และ Version 1.001 ทั้งหมดถูกกำหนดให้เป็น "แตกต่างกัน" แม้ว่าตัวเลขเหล่านี้อาจเป็นตัวแทนของขั้นตอนการพัฒนาเดียวกัน (เช่นการทำซ้ำหนึ่งครั้งนอกเหนือจากการเปิดตัวครั้งแรกครั้งแรก) ความแตกต่างของตัวเลขเวอร์ชันเหล่านี้เกิดขึ้นเนื่องจากการประชุมที่จัดตั้งขึ้นโดยผู้เขียนโครงการและโดยเครื่องมือที่พวกเขาใช้ในการรวบรวมแบบอักษรจากซอร์สโค้ดของพวกเขา คำจำกัดความของ Opentype ไม่ได้ระบุรูปแบบเพื่อระบุสถานะการพัฒนาของโครงการแบบอักษรที่เกี่ยวข้องกับเหตุการณ์สำคัญของรุ่นและไม่ได้กำหนดวิธีการในการรักษาข้อมูลเกี่ยวกับสถานะซอร์สโค้ดในเวลาที่สร้างภายในตัวอักษรสร้างสิ่งประดิษฐ์ การขาดมาตรฐานอย่างเป็นทางการเพื่อแก้ไขปัญหาข้างต้นซึ่งเป็นแรงผลักดันสำหรับข้อกำหนดนี้

ข้อมูลจำเพาะรุ่น Font Font (OpenFV) แสดงถึงส่วนขยายที่สอดคล้องกันของชื่อตาราง OpentYpe NameID 5 Record และ Opentype Head.FonTrevision ข้อมูลจำเพาะ OpenFV มีวัตถุประสงค์เพื่อทำหน้าที่เป็นมาตรฐานการกำหนดเวอร์ชันซอฟต์แวร์แบบอักษรสำหรับการพัฒนาการทดสอบการปล่อยและการใช้ซอร์สโค้ดแบบอักษรและสิ่งประดิษฐ์สร้าง (แบบอักษร) ที่ได้มาจากแหล่งที่มา ข้อกำหนดนี้กำหนดไวยากรณ์สตริงหมายเลขเวอร์ชันด้วยการสนับสนุนความหมายที่เก็บรักษาข้อมูลข้อมูลสำหรับทั้งนักพัฒนาและผู้ใช้

คำจำกัดความ

  • Build - ไฟล์ที่รวบรวมได้ของประเภทสิ่งประดิษฐ์สร้างแบบอักษรใด ๆ ที่กำหนดโดยสถานะของซอร์สโค้ด ณ เวลาที่สร้าง (เช่นไฟล์ไบนารีแบบอักษร)
  • การพัฒนา - ซอร์สโค้ดและคอมไพล์สร้างสถานะสิ่งประดิษฐ์ที่รวมถึงการดำเนินงานที่ไม่สมบูรณ์เพื่อให้บรรลุเป้าหมายการเปิดตัว
  • ข้อมูลเมตา - ข้อมูลที่อยู่นอกนิยาม OpenFV ของสตริงหมายเลขเวอร์ชัน
  • ตำแหน่งหนึ่ง - ตำแหน่งย่อยแรกของสตริงเวอร์ชัน
  • ตำแหน่งที่สอง - ตำแหน่งสตริงย่อยที่สองของสตริงเวอร์ชัน
  • รีลีส - ซอร์สโค้ดและคอมไพล์ ARTIFACT STATE MILESTONE สำหรับการใช้งานระดับการผลิตโดยผู้ใช้ปลายทาง
  • สถานะ - ตัวบ่งชี้ไบนารีของสถานะการพัฒนา/การเปิดตัวของซอร์สโค้ด
  • รัฐ - ตัวบ่งชี้สถานะซอร์สโค้ด ณ เวลาที่สร้าง

คำสำคัญ "ต้อง", "ต้องไม่", "จำเป็น", "จะ", "จะไม่", "ควร", "ไม่ควร", "แนะนำ", "พฤษภาคม" และ "ทางเลือก" ในเอกสารนี้จะถูกตีความตามที่อธิบายไว้ใน RFC 2119

ข้อกำหนด OpenFV

1. ชื่อตารางชื่อ 5 บันทึกเวอร์ชันบันทึก

. เวอร์ชันสตริงไวยากรณ์

สตริงเวอร์ชันในชื่อตาราง Opentype ID 5 บันทึกจะต้องกำหนดเป็น substrings semicolon dearimited ขององค์ประกอบข้อมูลบังคับและเพิ่มเติม

ไวยากรณ์ openfv ข้อมูลจำเพาะสำหรับองค์ประกอบย่อยของสตริงเวอร์ชันเต็มคือ: 

 [Font Version Number]; [Status/State Metadata]; [Other Metadata]

สตริงเวอร์ชันตัวอักษรต้องรวม:

  • สายย่อยหมายเลขฟอนต์

สตริงเวอร์ชันตัวอักษรอาจรวมถึง:

  • สถานะเมตาดาต้าสถานะ/สถานะ
  • ข้อมูลเมตาอื่น ๆ

ข. สตริงย่อยรุ่นฟอนต์

สายย่อยหมายเลขฟอนต์หมายเลข:

  • จะต้องอยู่ที่ตำแหน่งย่อยหนึ่ง
  • จะต้องถูกกำหนดให้เป็นคำว่า "เวอร์ชัน" ที่เป็นตัวพิมพ์ใหญ่, ช่องว่างอวกาศ (U+0020), หมายเลขรุ่นหลักตัวเลข MAJOR , ระยะเวลา (U+002E), ตัวเลขจำนวน MINOR
  • ต้องไม่รวมข้อมูลเมตา
  • อาจรวมถึงเครื่องหมายอัฒภาคที่ตำแหน่งอักขระสุดท้ายหากข้อมูลเมตาติดตามติดตามสายย่อยหมายเลขฟอนต์ที่ตำแหน่งย่อยสองตำแหน่ง ไม่ควรรวมอักขระช่องว่างระหว่างหมายเลขรุ่น MINOR และเครื่องหมายอัฒภาค
  • จะต้องไม่รวมเครื่องหมายอัฒภาคหากไม่มีข้อมูลเมตาตามสายย่อยหมายเลขเวอร์ชัน

หมายเลขเวอร์ชัน MAJOR :

  • ต้องมีตัวเลขระหว่างหนึ่งถึงสามหลักที่มีค่าต่ำสุด 0 และค่าสูงสุด 999

หมายเลขรุ่น MINOR :

  • ต้องมีสามหลักอย่างแน่นอน สำหรับตัวเลขที่น้อยกว่า 100 ต้องใช้ช่องว่างภายในเป็นศูนย์ในหมายเลขรุ่น MINOR หมายเลขรุ่น MINOR จะต้องมีค่าต่ำสุดของ 000 และค่าสูงสุด 999

ค. State Metadata Substring

State Metadata Substring:

  • จะกำหนดสถานะซอร์สโค้ด ณ เวลาสร้างแบบอักษร
  • เป็นทางเลือก
  • จะต้องอยู่ที่ตำแหน่งสตริงย่อยสองสตริงรุ่น FONT
  • ต้องไม่รวมอักขระที่อยู่นอกชุด: a-zA-Z0-9._-
  • ต้องรวมตัวคั่น [ เป็นอักขระเริ่มต้นและตัวคั่น ] เป็นอักขระสุดท้ายของสายย่อย เนื้อหาสตริงภายในตัวคั่นเหล่านี้จะถูกกำหนดให้เป็น "ป้ายกำกับสถานะ" ฉลากสถานะควรเป็น 50 อักขระหรือน้อยกว่า
  • อาจรวมถึงสตริงย่อยสถานะ (ดูด้านล่าง)

d. สตริงย่อยเมตาดาต้าสถานะ

Status Metadata Substring:

  • จะกำหนดสถานะการพัฒนาไบนารี/การเปิดตัวของซอร์สโค้ดและตัวอักษรสร้างตามที่กำหนดไว้ในส่วนคำจำกัดความ
  • เป็นทางเลือก
  • จะต้องอยู่ที่ตำแหน่งย่อยสอง
  • ต้องใช้หนึ่งในรูปแบบที่ไวต่อกรณีต่อไปนี้ที่มีอักขระพื้นที่ก่อนหน้าหนึ่งตัวหรือหนึ่งตัวสำหรับสตริงเวอร์ชันที่ไม่รวมสตริงย่อยสถานะ:
    • DEV
    • RELEASE
  • ต้องใช้หนึ่งในรูปแบบที่ไวต่อกรณีต่อไปนี้โดยไม่มีอักขระอวกาศก่อนหน้านี้สำหรับสตริงเวอร์ชันที่รวมถึงสตริงย่อยสถานะ:
    • -dev
    • -release

ก. ข้อมูลเมตาอื่น ๆ

ข้อมูลย่อยอื่น ๆ ของข้อมูลเมตา:

  • เป็นทางเลือก
  • อาจรวมหนึ่งครั้งขึ้นไปในสตริงเวอร์ชันตัวอักษร
  • ต้องติดตามข้อมูลย่อยหมายเลขทั้งหมดและข้อมูลสถานะ/สถานะ/สถานะด้วยตัวคั่นเซมิโคลอนตามด้วยอักขระศูนย์หรือหนึ่งอักขระหนึ่งก่อนหน้าของเมตาดาต้าย่อย
  • ควรถูก จำกัด ไว้ที่ 50 อักขระหรือน้อยกว่า

2. Head Table Fontrevision Record String String

หมายเลขเวอร์ชันตัวอักษรในบันทึก Fontrevision ของตารางหัว Opentype:

  • จะต้องกำหนดเป็นตัวเลขหลักหมายเลข MAJOR , ระยะเวลา, ตัวเลขหมายเลขรุ่น MINOR
  • ต้องมีหมายเลขเวอร์ชันหลักที่มีความยาวหนึ่งถึงสามหลักโดยมีค่าต่ำสุด 0 และค่าสูงสุด 999
  • ต้องมีหมายเลขรุ่น MINOR ที่มีความยาวสามหลัก สำหรับหมายเลขรุ่น MINOR น้อยกว่า 100 ต้องใช้ช่องว่างภายในเป็นศูนย์ หมายเลขรุ่น MINOR จะต้องมีค่าต่ำสุดของ 000 และค่าสูงสุด 999
  • ต้องไม่รวมอักขระใด ๆ ก่อนหมายเลขเวอร์ชัน MAJOR หรือหลังจากหมายเลขรุ่น MINOR

3. ความหมายหมายเลขหมายเลข

  • หมายเลขรุ่น MAJOR.MINOR จะต้องมีจุดประสงค์เพื่อแสดงถึงเหตุการณ์สำคัญที่อาจนำไปใช้อย่างไม่สมบูรณ์ในแหล่งที่มาซึ่งกำหนดด้วยหมายเลขรุ่น MAJOR.MINOR หมายเลขรุ่น MAJOR.MINOR จะไม่ได้มีวัตถุประสงค์เพื่อแสดงสถานะซอร์สโค้ดในเวลาสร้างในการสร้างสิ่งประดิษฐ์และอาจไม่เป็นเอกลักษณ์ในการสร้างสิ่งประดิษฐ์เนื่องจากการทำงานจะดำเนินการเพื่อให้บรรลุสำคัญครั้ง MAJOR.MINOR
  • สถานะแหล่งที่มาของการพัฒนาควรแตกต่างจากสถานะแหล่งที่มาของการเปิดตัวผ่านการใช้สตริงย่อยเมตาดาต้าสถานะตามที่กำหนดไว้ในข้อกำหนดนี้
  • หมายเลขเวอร์ชัน MAJOR ควรตั้งค่าเป็น 0 ในระหว่างขั้นตอนการพัฒนาก่อนการพัฒนาก่อนการเปิดตัวครั้งแรก หมายเลขเวอร์ชัน MAJOR 0 จะระบุขั้นตอนการพัฒนาก่อนการผลิตนี้
  • หมายเลขเวอร์ชัน MAJOR จะต้องตั้งค่าเป็น 1 ในเวลาของการเปิดตัวครั้งแรกถึงผู้ใช้ปลายทาง การแปลงจากหมายเลขรุ่น MAJOR 0 เป็น MAJOR หลักหมายเลข 1 จะระบุการรับทราบของผู้เขียนว่าซอร์สโค้ดและสร้างสิ่งประดิษฐ์ตรงตามคำจำกัดความของ OpenFV
  • เมื่อเสร็จสิ้นการเปลี่ยนแปลงซอร์สโค้ดเพื่อให้บรรลุเหตุการณ์สำคัญการเพิ่มจำนวนเวอร์ชันควรดำเนินการทันทีก่อนที่จะทำการเปลี่ยนแปลงซอร์สโค้ดที่มีไว้สำหรับเหตุการณ์สำคัญในอนาคต

ความหมายสำหรับการเปลี่ยนแปลงหมายเลขเวอร์ชันจะรวมถึงการเพิ่มขึ้นโดยค่า 1 ของ:

  • หมายเลขเวอร์ชัน MAJOR สำหรับการเสร็จสิ้นของเหตุการณ์สำคัญเฉพาะโครงการและการเปลี่ยนแปลงที่เข้ากันไม่ได้ทั้งหมดที่เกิดขึ้นกับซอฟต์แวร์แบบอักษร (เช่นการกำจัดการสนับสนุนสำหรับช่วงรหัส Unicode ทั้งหมด)
  • หมายเลขรุ่น MINOR สำหรับฟังก์ชั่นการเปลี่ยนแปลง HotFix และการพึ่งพา ตัวอย่าง ได้แก่ :
    • การเปลี่ยนแปลงการออกแบบ Glyph
    • การเพิ่ม/การกำจัด/การดัดแปลงชุดคำแนะนำ/คำสั่ง
    • การเพิ่ม/การกำจัดร่ายมนตร์
    • การออกแบบการแก้ไขข้อบกพร่อง
    • การเปลี่ยนแปลงเพื่อสร้างกระบวนการ
    • อัปเดตการพึ่งพาบิลด์

เมื่อหมายเลขเวอร์ชัน MAJOR เพิ่มขึ้นหมายเลขรุ่น MINOR จะถูกเปลี่ยนเป็นค่า 000

ตัวอย่าง

ชื่อตารางชื่อ 5 บันทึก

ตัวอย่างของชื่อตารางชื่อ ID 5 สตริงเวอร์ชันบันทึกที่ตรงตามข้อกำหนดของ OpenFV รวมถึง:

หมายเลขเวอร์ชันเท่านั้น 
 Version 1.001
หมายเลขเวอร์ชันและสถานะการพัฒนาสถานะ 
 Version 1.001; DEV
Version 1.001; RELEASE
หมายเลขเวอร์ชันและรหัสแหล่งที่มาของรหัส 
 Version 1.001; [abcd123]
หมายเลขเวอร์ชัน, ฉลากสถานะรหัสซอร์สและฉลากสถานะการพัฒนา 
 Version 1.001; [abcd123]-dev
Version 1.001; [abcd123]-release
หมายเลขเวอร์ชัน, ฉลากสถานะรหัสซอร์ส, ฉลากสถานะการพัฒนาและข้อมูลเมตาอื่น ๆ 
 Version 1.001; [abcd123]-dev; here are metadata
Version 1.001; [abcd123]-release; here are metadata
หมายเลขเวอร์ชันและข้อมูลเมตาอื่น ๆ 
 Version 1.001; here are metadata
Version 1.001; here are metadata; here are more metadata

บันทึกตาราง fontrevision

ตัวอย่างของตาราง head fontrevision record strings ที่ตรงกับข้อกำหนดของ OpenFV รวมถึง: 

 1.001

 10.010

 100.100

ใบอนุญาต

CC โดย 4.0

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด