Protocol5

Variable-Base Mathematics

Exact arithmetic, radix conversion, sequence references, and educational number-system pages collected into one publishable shell.

UAI-1 / ชุดติดตั้ง

ชุดรองรับเว็บไซต์ C# สำหรับ UAI-1

หน้านี้เผยแพร่ชุดดาวน์โหลดเริ่มต้นของ Protocol5 สำหรับเพิ่มการรองรับ UAI-1 ให้กับเว็บไซต์ C# โดยเฉพาะเว็บไซต์ ASP.NET Core ที่ต้องการแนวทางใช้งาน CultureInfo และ Accept-Language แบบปฏิบัติได้จริง โดยไม่ทำให้ semantic แบบแคนนอนิคัลของ UAI ต้องขึ้นกับกฎการจัดรูปแบบภาษามนุษย์ในท้องถิ่น

คลัง UAI ข้อกำหนด UAI-1 คู่มือ Radix 63404

Raw / developer layer

UAI language source and developer tools

The public page renders compact UAI as an alternate language layer. JSON, linked registries, and validation schema remain here for developer inspection.

Compact UAI index.uai.json uai-1.schema.json symbols.schema.json uai-1.json uai-1-examples.json symbols.json UAI-1-examples.json validate registry validate Human companion
Loading compact UAI language source...
Loading compact source...

Protocol5 is fetching the compact UAI language source before developer JSON.

Language layer

ชุดรองรับเว็บไซต์ C# สำหรับ UAI-1

Use the view control to switch between human prose, rendered UAI, and raw developer inspection. The rendered UAI mode keeps this page layout intact and changes only the text layer.

ชุดรองรับเว็บไซต์ C# สำหรับ UAI-1

หน้านี้เผยแพร่ชุดดาวน์โหลดเริ่มต้นของ Protocol5 สำหรับเพิ่มการรองรับ UAI-1 ให้กับเว็บไซต์ C# โดยเฉพาะเว็บไซต์ ASP.NET Core ที่ต้องการแนวทางใช้งาน CultureInfo และ Accept-Language แบบปฏิบัติได้จริง โดยไม่ทำให้ semantic แบบแคนนอนิคัลของ UAI ต้องขึ้นกับกฎการจัดรูปแบบภาษามนุษย์ในท้องถิ่น

ข้อมูลเอกสาร

สิ่งที่อยู่ในชุดดาวน์โหลด

  • โปรเจ็กต์ซอร์ส Protocol5.UAI.CSharp
  • ไฟล์ .nupkg ของ Protocol5.UAI.CSharp ที่แพ็กไว้แล้ว
  • ตัวช่วยเข้ารหัสและถอดรหัส Radix 63404
  • มิดเดิลแวร์ ASP.NET Core ที่รู้จักคำขอ UAI จาก query string, cookie หรือ Accept-Language
  • readme ติดตั้งขนาดสั้นสำหรับทีมที่ต้องการดาวน์โหลดตรงแทนการใช้ package feed

เหตุใด starter นี้จึงใช้ x-uai-1

สำหรับเว็บไซต์ การแยกหน้าที่ที่ชัดเจนคือ:

  • ใช้ x-uai-1 สำหรับ HTML lang, การเจรจาคำขอ และ Content-Language
  • ใช้ CultureInfo.GetCultureInfo("x-uai-1") เมื่อ runtime รองรับ
  • ใช้ CultureInfo.InvariantCulture เมื่อ serialize ค่าของ UAI แบบแคนนอนิคัล

กฎข้อสุดท้ายนั้นสำคัญมาก เพราะ UAI-1 ถูกนิยามให้เป็นภาษาของเครื่องแบบแคนนอนิคัล ตัวคั่นทศนิยม รูปแบบวันที่ และธรรมเนียมการแสดงผลของแต่ละท้องถิ่น จะต้องไม่เปลี่ยนความหมายที่ถูก serialize ของข้อความ UAI

เหตุใดสิ่งนี้จึงไม่ใช่แค่ตัวติดตั้ง culture บน Windows

แนวทางด้าน globalization ของ Microsoft แยกความต่างสำคัญไว้ดังนี้:

  • CultureInfo คือจุดเข้าใช้งานตามปกติของ runtime สำหรับพฤติกรรมที่อ่อนไหวต่อ culture
  • CultureAndRegionInfoBuilder มีไว้สำหรับสร้าง culture แบบกำหนดเอง แต่แนวทางนั้นผูกกับ Windows และไม่ใช่ค่าเริ่มต้นที่เหมาะสำหรับการนำไปใช้บนเว็บไซต์ข้ามแพลตฟอร์ม

ด้วยเหตุนี้ starter ของ Protocol5 ตัวนี้จึง ไม่ ต้องการการลงทะเบียน custom culture ในระดับระบบปฏิบัติการ มันให้เส้นทางที่ใช้งานได้จริงแก่เว็บไซต์ก่อน และปล่อยเรื่องการลงทะเบียน culture ที่เฉพาะแพลตฟอร์มไว้เป็นขั้นสูงแบบเลือกใช้

เริ่มต้นอย่างรวดเร็ว

ติดตั้งจากไฟล์แพ็กเกจที่ดาวน์โหลดมา:

dotnet add package Protocol5.UAI.CSharp --source .\downloads

จากนั้นต่อเข้ากับเว็บไซต์ ASP.NET Core:

using Protocol5.UAI;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddProtocol5UaiWebsiteSupport();

var app = builder.Build();
app.UseProtocol5UaiWebsiteSupport();

app.MapGet("/uai-demo", (HttpContext context) =>
{
    var sampleCanonicalId = Radix63404.Encode(5651);

    return Results.Json(new
    {
        protocol = UaiCultureInfo.CanonicalVersion,
        language = context.GetProtocol5HtmlLanguage(),
        sampleCanonicalId
    });
});

app.Run();

คำแนะนำสำหรับ HTML

หากหน้าหนึ่งตั้งใจจะประกาศเนื้อหาที่รองรับ UAI โดยตรง ให้ใช้:

<html lang="x-uai-1">

กฎการจัดรูปแบบแบบแคนนอนิคัล

เมื่อ serialize ค่าของ UAI แบบแคนนอนิคัล ให้ใช้ InvariantCulture เสมอ:

using Protocol5.UAI;

var confidence = 0.875m.ToString(UaiCultureInfo.CanonicalSerializationCulture);

ตัวอย่าง Radix 63404 ที่มากับชุดเครื่องมือ

Radix63404.Encode(41);        // J
Radix63404.Encode(5651);      // ᙖ
Radix63404.Encode(267914296); // Ⴤ绠

ลิงก์ดาวน์โหลด