6 Commits

Author SHA1 Message Date
Dave Pearson
d4eb0a0c20 Only link Python and Rich types when building full docs
It looks like mkdocstrings will fail out if it can't download the inv files.
Unless there's a setting where you can tell it "try, but if you can't grab
them just don't try and create links" the approach here seems reasonable and
has the same effect.

https://github.com/Textualize/textual/issues/2629#issuecomment-1566672594
for reference.
2023-05-29 08:30:23 +01:00
Dave Pearson
a295c5f968 Work towards having a single nav file
The idea here is that there is a single file for the nav for all the docs,
both online and offline. The nav will be the full online nav in all its blog
glory, and then the build system will strip out the nav items relating to
the blog when building the offline version.

There's a wrinkle or two still in here; the main one being that when doing a
docs-serve, it seems that the cleaning up of the online nav doesn't happen
when you Ctrl-C out of the server. I'm not 100% sure of the cause of
this (there could be a couple of different reasons).

For now... I'm ensuring that the online/offline nav files are excluded from
git. It would be nice to find out how best to always ensure that the online
nav file is removed so nobody attempting to update the docs gets confused
about what to edit.
2023-02-08 14:36:56 +00:00
Dave Pearson
86e1997b30 Merge branch 'main' into package-docs 2023-02-08 10:40:20 +00:00
Dave Pearson
93f449366f Modify blog/rss plugin config to make search work again
Inheriting config for mkdocs requires that you use key/value pairs for the
plugins not a list of objects.
2023-02-08 08:41:16 +00:00
Dave Pearson
fb5346c894 Don't show the repository stats in offline mode
They require a connection, which isn't very offline...
2023-02-08 08:40:47 +00:00
Dave Pearson
a8aaa7ad82 Experiment with the mkdocs offline plugin
In doing so, don't emphasise online docs over offline, but instead make this
about an online/offline split and both are as important as each other.
2023-02-07 10:06:05 +00:00