Proposal for OOXML Extension to Support Interactive UUID Widgets

Đang mở
  • Có gì không ổn?
#333 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
20/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Đình trệ
Công nghệ
xml
Lĩnh vực
documentation

Hướng nghiên cứu

Không có tệp, bài kiểm thử hoặc điểm đầu vào triển khai nào được đề cập. Hãy bắt đầu bằng việc xem xét tài liệu OOXML của repository và xác định liệu phần mở rộng được đề xuất này có nằm trong phạm vi hay không; để được xem là hoàn tất, cần có một thiết kế đã được thống nhất và kế hoạch triển khai trước khi viết mã.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

With the recent publication of RFC 9562, which standardized UUIDv7 for use as primary keys in databases and distributed systems, and with the implementation of UUIDv7 in PostgreSQL and other DBMS and programming languages, UUIDs have become extremely popular.

However, their canonical lengthy textual representation is inconvenient. Many attempts to reduce its length using different encodings have been unsuccessful. This proposal introduces an interactive UUID widget for Office Open XML (OOXML) to fundamentally reimagine UUID representation. Instead of textual encodings, UUIDs would be embedded into documents as single-character graphical elements.

Additionally, this proposal makes it much easier to copy UUIDs because it is impossible to select an entire UUID with mouse clicks.

Core Functional Requirements

Visual Representation
  • UUIDs should be represented by a single Unicode character ◘ (U+25D8, inverse bullet) rendered in #50A5FF (light blue).
  • Optional substitution with dynamically generated identicons (e.g., SVG-based patterns) for visual distinction between UUIDs.
Interactive Behavior
Hover Activation
Right-Click (or Tap and Hold)
  • Copy UUID, description and hyperlink to clipboard
  • Display a tooltip
Copy Canonical UUID Text Representation to Clipboard
  • Copy UUID to clipboard
  • UUID validation
Left -Click (or Tap)
  • Insert the UUID widget into the hypertext document, accompanied by an undo notification to prevent accidental insertions
  • Or insert the UUID in canonical UUID text representation (e.g., 01954431-f01a-7094-9612-da3fb99f16d1) into the plain text document
Find UUID in Document
  • Select all such particular UUIDs and corresponding UUID widgets in the document
Opening a document in applications that do not support the proposed OOXML Extension
  • Displaying UUID in canonical UUID text representation
Tooltip Content
  • Canonical UUID text representation
  • Dynamically generated identicon corresponding to this particular UUID
  • UUID version and variant metadata extracted from UUID
  • Date and time extracted from the UUID timestamp (for time-ordered UUIDs)
  • Description field (editable)
  • Hyperlink field (editable)
  • Context menu
Context Menu Items
  • Search/replace across document or external systems (local databases, web)
  • Follow the hyperlink
  • Toggle between character ◘ and identicon views across document
  • Delete

Benefits

  • Reduced Visual Clutter: Eliminates lengthy UUID strings from document.
  • Enhanced Usability: One-click access to UUID manipulation tools accelerates workflows in technical documentation, software specifications, and asset tracking.
  • Interoperability: Compatible with existing UUIDv4/v7 standard (RFC 9562).

Sergey Prokhorenko
Mentioned contributor to RFC 9562 "Universally Unique IDentifiers (UUIDs)"
Email: [email protected]

Ngôn ngữ chính
PowerShell
Star
109
Fork
72
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của OfficeDev/open-xml-docs

Tất cả issue của OfficeDev/open-xml-docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.