Skip to content
This repository has been archived by the owner on Oct 23, 2022. It is now read-only.

Fix relative paths in new emitter docs #131

Merged
merged 2 commits into from
Apr 21, 2021
Merged

Conversation

alfredclwong
Copy link
Collaborator

@alfredclwong alfredclwong commented Apr 21, 2021

I think that the confusion came from me enabling the prettyurls argument in makedocs in docs/make.jl.

Enabling this option probably did more harm than good. It made locally built docs easier to navigate, but it meant that the local and remote doc builds differed in directory structure, which is confusing and difficult to work with.

We need to go back one time because the html paths are relative to docs/build/emitters_new/index.html rather than
docs/build/emitters_new.html, which is what the prettyurl doc build would have you believe. Confusingly, julia code is executed from docs/build, which means that Vis.save shouldn't go back in its relative path!

Will upgrade this from a draft PR once the preview confirms the fix.

Fixed!

@alfredclwong alfredclwong changed the title 129/fix new emitter docs Fix relative paths in new emitter docs Apr 21, 2021
@alfredclwong alfredclwong marked this pull request as ready for review April 21, 2021 20:42
@alfredclwong alfredclwong merged commit 8a55465 into main Apr 21, 2021
@alfredclwong alfredclwong deleted the 129/fix-new-emitter-docs branch April 21, 2021 20:43
Enabling this option probably did more harm than good. It made locally
built docs easier to navigate, but it meant that the local and remote
doc builds differed in directory structure, which is confusing and
difficult to work with.
We need to go back one time because the html paths are relative to
docs/build/emitters_new/index.html rather than
docs/build/emitters_new.html, which is what the prettyurl doc build
would have you believe.

Fixes #129
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants