Dewikification: Content app improvements.#468
Conversation
Make category `title` consistent with page `title`. Simplify `icon` key, since there is no benefit to defining the icon class and the icon separately. Allow overriding the `icon` for category entries just like page entries.
This is useful for our /contributing pages, which have a main contributing page at /contributing but project pages under the same path, /contributing/bot etc.
Adds image caption capabilities and documents missing HTML extensions available.
kosayoda
added
type: feature
|
tfw when you do everything except update tests |
|
|
||
| In the above example, `www.pythondiscord.com/guides/` will list `Contributing` as a category entry with information from `contributing/_info.yml`. | ||
|
|
||
| However, `www.pythondiscord.com/guides/contributing` will render `contributing.md` rather than show the category contents, so *it is the article's responsibility to link to any subpages under the article*. |
There was a problem hiding this comment.
Have you considered any way to show the direct children, or even all children? Perhaps a dropdown menu somewhere, like near the breadcrumbs.
There was a problem hiding this comment.
I have. Since I'm just trying to get feature parity with the current site, I'll open a separate issue for this so the app can move along.
There was a problem hiding this comment.
Plot twist: I did it anyways since it's not a big change. The dropdown only shows up on category-page-hybrids and look and function similar to the one shown on the current site when you're logged in.
The differences are that it only shows direct children, since any sub-categories show their children on their page anyway, and that the dropdown is click-toggled and not hover-toggled to be mobile-friendly.
|
Just realized there's a logic error in the category page path, will fix. |
kosayoda
force-pushed
the
content-app-improvements
branch
from
22d6dbb to
ffad966
Compare
This only shows when the page is also a category, since regular pages have no children and regular categories already list their children.
This was causing mysterious 404s because while migrating a feature to dewikification, the same variable would be placed in the settings file.
This allows us to keep filenames (thus URLs) as concise as possible, while having a more descriptive entry in the Sub-Articles dropdown for category pages.
3 participants
Simplifications
titleas the key to match page metadata, previously it wasname.icon.Structure enhancements
This PR adds a way to have a path be both a category and a page. This is useful for places like
/contributing, where https://pythondiscord.com/pages/contributing/ is a rendered page while still being a category for https://pythondiscord.com/pages/contributing/sir-lancebot/ and the like.Markdown additions
Certain markdown-to-html additions were made to enable feature parity with the current
wiki-ed site guides, but without the article writer needing to write HTML.Specifically, these features are added: