Skip to content

Support V1 wiki folder layout#27

Open
Su5eD wants to merge 17 commits into
Rearth:mainfrom
Su5eD:format-v1
Open

Support V1 wiki folder layout#27
Su5eD wants to merge 17 commits into
Rearth:mainfrom
Su5eD:format-v1

Conversation

@Su5eD

@Su5eD Su5eD commented Jun 9, 2026

Copy link
Copy Markdown

The proposal

Brings Oracle Index up to date with the latest available Wiki features.

The main change is the support for the new "stable" folder layout, which I've recently introduced to eliminate the tech debt the old format had built up. It changes the paths of various elements, but not their contents.

Changes

  • Added support for V1 wiki folder layout (see docs for spec)
  • Fixed item tooltip components having broken translation (because the reloader listener was being called before the language manager's own listener) by using a lazy value to get the translation
  • When opening a page from the inventory or switching between docs tabs, the tree will expand to show the currently selected page automatically
  • Fixed content page titles having uneven horizontal padding
  • Made ModAsset an alias of Asset and aligned their behavior (this is how they work on the Wiki - ModAsset is just an old name for Asset)
  • Updated Loom to 1.13 and Gradle to 9.5.1. The old versions had some issue setting up the workspace for some reason so I just updated them
  • Replaced docs mode literals with enum

Tasks

  • Add support for multi-item pages
  • Add support for [](+page_ref) page ref links
  • Add test docs mod demonstrating compatible features
  • Color coded Callout titles
  • Inline code should not just be "red text" that makes it look like an error
  • Change item tooltip text to just "Documentation available" instead of showing page name - in practice they're often the same
  • Get title from H1
  • Hide duplicate title in pages
  • Fix navigation not updating tree

@Rearth

Rearth commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Hi, huge thanks for the draft PR. I recently saw the announcement for the new layout and though that looked pretty good, but dreaded making the oracle index required, so I'm very happy to see you working on it already. Although I feel a bit bad about someone else having to look at the terrible code I created here 😄 But from what I'm seeing so far you're doing a great job improving it, so huge thanks already. Regarding the open suggestions / questions:

  • Yes different colors for the different callout variant would probably be a great thing to have
  • Inline code formatting could be much better, yeah.
  • A different item tooltip would probably be a good idea. Maybe combining the tooltip to saying "Hold Alt for Documentation" instead of the currently split layout or something would probably be best.

@Su5eD

Su5eD commented Jun 11, 2026

Copy link
Copy Markdown
Author

Alright, this should be good to go.

Below's a few screenshots I took while testing to show the new changes. You can use the test mod by running runTestmodClient to check if everything works on your end as well :)

Colored callouts
Screenshot 2026-06-11 at 20 54 25
Multi-item page
Screenshot 2026-06-11 at 20 57 38
Each item is shown below the title
(if icon is set in the frontmatter, it appears next to the title just like in single-item pages)
Pagination
Screenshot 2026-06-11 at 20 59 59
Items are wrapped in rows if they exceed the reading width
Item tooltips
Screenshot 2026-06-11 at 21 02 10
Tooltip now shows generic text

@Su5eD Su5eD marked this pull request as ready for review June 11, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants