Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Manual infra-estructure

Đang mở
#199 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

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
25/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Đình trệ
Công nghệ
php, xml

Hướng nghiên cứu

Đây là một checklist theo dõi phạm vi rộng thay vì một thay đổi đơn lẻ. Trước tiên, hãy xác nhận mục nào chưa được đánh dấu nằm trong phạm vi, chẳng hạn như tạo lại --langs-dir trong configure.php và các sub-script của nó, hoặc chuyển các tệp đã tạo vào doc-base/temp/. Done có nghĩa là hoàn thành mục checklist đã chọn và cập nhật issue với kết quả của mục đó.

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

Mô tả

Planned changes, big and small, that affect manual infrastructure and languages.

Configure
  • List of active languages on `doc-base (#186)
  • Nested/recursive XIncludes (#194)
  • XInclude failures less fatal on translations (#196)
  • XInclude by xml:id (#198)
  • Include post validation tools on configure.php (broken, revtag, entities). (#241)
  • XML Entities (#183) (#301)
  • Smaller XML output (comments, DTD, namespaces, docbook wsi) (#321)
  • Recreate --langs-dir on configure.php and sub scripts
Idempotent build
  • Create doc-base/temp and .gitkeep it (#200)
  • Rewrite file-entities.ent.in to use temp/ (#201)
  • Change configure.php to be a little more idempotent (#202)
  • Change manual.xml.in into stable manual.xml (#210)
  • Move PhD files PhD repo (https://github.com/php/phd/pull/261)
  • Move PhD files to doc-base/temp/
  • Move .manual.xml to doc-base/temp/ (coordenate with PhD)
  • Move remaining .gitignore files to temp/
Manual split and DTD entites
  • Move manual.xml from doc-base to doc-en (#324)
  • Move/merge XML files from doc-base to doc-en (https://github.com/php/doc-en/pull/5682)
  • Move/convert entitiy files from doc-base to doc-en (https://github.com/php/doc-en/pull/5742)
  • Minimize DTD inclusion on doc-base/manual.xml (#336)
  • Erase manual.xml, funcindex.xml and global.ent from doc-base (#338)
  • Remove all mentions of funcindex.xml from code (#338)
  • Split, convert and delete language-snippets.ent
Recheck
  • Single source revcheck (#111 #174 #176 #180)
  • Sequential [skip-revcheck] (#178)
  • Accidental [skip-revcheck] (#181)
  • <?do-not-translate?> mark support on doc-base(#311)
  • Annotate files on doc-en
  • Remove file exclusions by name convention from revcheck lib (#319)
  • "Do not translate" and "XML Broken" sections in revcheck (#334)
Performance/tools
  • Avoid file entities for directories as individuai files (#218)
  • Rewrite sync XML for Attributes (#215)
  • Rewrite sync XML for Entities (#219)
  • Rewrite sync XML for Processing Instructions (#222)
  • Rewrite sync XML for Tags (#222)
  • Rewrite sync XML for Whitespace (#222)
  • Move generation of sources.xml and version.xml at the end of configure.php (#239)
  • Sync XML tools to accept language parameter and simple file listing (#275)
  • Do-not-translate mark, broken test and revtag parse in one file load (#339)
Clean up / TODOs
  • Trim local repository status on configure.php (#205)
  • Remove $mixin from doc-base/scripts/file-entities.php (#207)
  • Remove BACKPORT from doc-base/scripts/file-entities.php (#213)
  • Rewrote $mixin as an check/error on all OS (#213)
  • Remove all mentions of <xi:fallback> in doc-en (https://github.com/php/doc-en/pull/5699)
  • Block <xi:fallback> on doc-en (#332)
Future / R&D
Failed
  • Native `DOMDocument->xinclude() (?)
  • LIBXML_NOBLANKS (#304)
  • LIBXML_NSCLEAN (#315)
  • GitHub actions/checkout merge stuck in the past (#329)
Ngôn ngữ chính
PHP
Star
373
Fork
131
Merge trung bình
3 ngày 12 giờ
Pull request đã merge (30 ngày)
8

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

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 php/doc-base

Tất cả issue của php/doc-base

Issue tương tự

Thêm issue về PHP

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.