imbajin opened a new pull request, #565:
URL: https://github.com/apache/hugegraph-doc/pull/565

   ## Upgrade
   
   Upgrade the documentation site from **OINK 1.4.0 to 1.5.1** and enable its 
native **Duo View**. Readers can open published English and Chinese 
translations side by side from the page button, the Command Palette, or the `B` 
shortcut. On a phone, tabs switch between the two languages. The second 
document loads on demand, and Sync Scroll follows matching headings when 
available.
   
   ![Scrolling the English HugeGraph Server quick start keeps the Chinese 
translation in 
sync](https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/sync-scroll.gif)
   
   ## What changed
   
   | Area | Change |
   | --- | --- |
   | Theme and toolchain | Pin OINK 1.5.1 and both module checksums. Refresh 
the reviewed theme overrides and align Netlify previews with the strict Hugo 
Extended and Go build used by CI. |
   | Navigation and translations | Use OINK’s page-specific translation lookup 
for the Command Palette. Navbar-only mobile pages expose language, appearance 
and release controls in the drawer. |
   | Archived documentation | Mount both pane URLs and page identity markers 
under `/versions/<id>/`. Readers stay on the selected release when comparing 
translations. A marker mismatch previously left both panes showing Retry. |
   | Shell and AI consent | Keep article interactions active in both panes. The 
outer page owns navigation, language preferences and Kapa consent, so opening a 
translation does not initialize a second AI widget. |
   | Configuration tables | Size the key column to fit long RocksDB and PD 
settings in both languages. Descriptions still wrap and narrow screens can 
scroll the table horizontally. The archive build applies the same rule to the 
affected historical RocksDB tables. |
   | Upgrade checks | Run the upgrade checks before recording the new override 
baseline. Browser tests wait for both panes to become readable and cover 
history, mobile tabs, Sync Scroll, timeout recovery and retry. |
   
   ### Archived Docs on the same 1.7 URL
   
   | Both panes showed Retry | Both panes show the selected release |
   | --- | --- |
   | ![Archived English and Chinese panes showing 
Retry](https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/archive-1.7-before.png)
 | ![The same 1.7 page showing both 
translations](https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/archive-1.7-after.png)
 |
   
   <details>
   <summary>Mobile translation tabs and configuration table 
screenshots</summary>
   
   <img 
src="https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/mobile-translation.png";
 width="300" alt="Mobile Duo View with the Chinese translation selected">
   
   | Wrapped RocksDB key | Complete key on one line |
   | --- | --- |
   | ![The last character 
wraps](https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/rocksdb-before.png)
 | ![The full RocksDB configuration key 
fits](https://raw.githubusercontent.com/hugegraph/hugegraph-doc/af1709b15e209c05e020b59901b45800855a96ec/pr-65/rocksdb-after.png)
 |
   
   </details>
   
   ## Verification
   
   The local Duo View checks passed on latest, 1.7, 1.5, 1.3 and 1.0 across 
both languages and viewport sizes. All 68 configuration-table browser checks 
passed on macOS, including the 12 cases that previously wrapped a key. Book 
comparison uses OINK’s native translation discovery. HugeGraph currently has no 
published bilingual Book page to test.
   
   The fork and this PR use the same source branch. [Fork 
verification](https://github.com/hugegraph/hugegraph-doc/actions/runs/43618248318)
   
   Staging verification and production publication are separate release steps.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to