Skip to content

doc: update conf.py and add js for URL migration - #1397

Merged
roosterfish merged 3 commits into
canonical:mainfrom
elijahgreenstein:migrate-main
Jul 14, 2026
Merged

doc: update conf.py and add js for URL migration#1397
roosterfish merged 3 commits into
canonical:mainfrom
elijahgreenstein:migrate-main

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

Checklist

@github-actions github-actions Bot added the Documentation Documentation needs updating label 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 :)

Comment thread doc/_static/js/overwrite_links.js Outdated
@roosterfish

Copy link
Copy Markdown
Contributor

Should we start with this one first, or do we have to merge all of them at around the same time as we switch "all" the docs from ubuntu.com to canonical.com?

@elijahgreenstein

Copy link
Copy Markdown
Contributor Author

Once we get the go ahead, we should merge both of the MicroCloud updates around the same time, so that the entire MicroCloud doc set is moved to canonical.com at once. This does not need to be synced with the LXD docs, however, which can moved at a different time.

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>
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>
- 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>
@elijahgreenstein
elijahgreenstein marked this pull request as ready for review July 14, 2026 01:08
@elijahgreenstein

Copy link
Copy Markdown
Contributor Author

@roosterfish -- this is ready to go now.

@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.

Thanks!

Comment thread doc/conf.py
@roosterfish
roosterfish merged commit e174187 into canonical:main Jul 14, 2026
19 checks passed
@elijahgreenstein
elijahgreenstein deleted the migrate-main branch July 17, 2026 17:18
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