Skip to content

doc: update conf.py and add js for URL migration (v2-edge)#1398

Draft
elijahgreenstein wants to merge 3 commits into
canonical:v2-edgefrom
elijahgreenstein:migrate-v2-edge
Draft

doc: update conf.py and add js for URL migration (v2-edge)#1398
elijahgreenstein wants to merge 3 commits into
canonical:v2-edgefrom
elijahgreenstein:migrate-v2-edge

Conversation

@elijahgreenstein

Copy link
Copy Markdown
Contributor

These changes support migration of the documentation from documentation.ubuntu.com/microcloud to canonical.com/microcloud/docs:

  • Adds doc/_static/js/overwrite_links.js to properly handle links in the flyout menu (version selector).
  • Updates configuration settings in doc/conf.py
  • Reorganizes JavaScript files into doc/_static/js directory, and updates relevant paths

(cherry picked from commit 52587cb)

Checklist

@github-actions github-actions Bot added the Documentation Documentation needs updating label Jun 2, 2026
@elijahgreenstein elijahgreenstein changed the title doc: update conf.py and add js for URL migration doc: update conf.py and add js for URL migration (v2-edge) Jun 2, 2026
roosterfish
roosterfish previously approved these changes Jun 3, 2026

@roosterfish roosterfish left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, ready when you give the green light :)

@elijahgreenstein elijahgreenstein force-pushed the migrate-v2-edge branch 6 times, most recently from 1a08487 to a27d513 Compare June 5, 2026 03:52
@elijahgreenstein elijahgreenstein force-pushed the migrate-v2-edge branch 5 times, most recently from 50b93db to 740465e Compare July 7, 2026 22:43
These changes support migration of the documentation from
documentation.ubuntu.com/microcloud to canonical.com/microcloud/docs:

- Adds `doc/_static/js/overwrite_links.js` to properly handle links in
  the flyout menu (version selector).
- Updates configuration settings in `doc/conf.py`
- Reorganizes JavaScript files into `doc/_static/js` directory, and
  updates relevant paths

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit c155dbd)
This commit removes the "Contribute to this page" button. This change is
temporary, and the button will be restored after the docs have moved to
canonical.com.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit e599f5a)
- Copies the MicroCloud `overwrite_links.js` file into the cloned LXD,
  MicroCeph, and MicroOVN repos as `overwrite_microcloud_links.js`, so
  that the JavaScript loads across the integrated docs
- Prefixes functions and variables in the MicroCloud
  `overwrite_links.js` file with `microcloud_` in order to prevent
  conflicts with the equivalents in the LXD, MicroCeph, and MicroOVN
  `overwrite_links.js` files.
- Reconfigures the Makefile to append `add_config.py` to the end of the
  MicroOVN `conf.py` so that the addition of
  `overwrite_microcloud_links.js` to `html_js_files` applies to
  MicroOVN.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit c19f795)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation needs updating

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants