I see that the install guide has
./modules/install-guide/pages/_partials/entities.adoc
with things like
:PREVVER: 33 :PRODUCT: Fedora :PRODVER: Rawhide :YEAR: 2021
which is pulled in by
include::{partialsdir}/entities.adoc[]
On the wiki, we have macros that can be used ... anywhere on the whole thing. It'd be nice to have that, for example for refering to our new chat server by URL.
Is there a way we can do that?
Also: is there a way we can make parameterized macros? Like, something where we can say {CHATROOM:council}[Fedora Council] and it'll automatically link that to
https://matrix.to/#/#matrix-meta-chat:fedoraproject.org?web-instance%5Beleme...
?
On Mon, Oct 11, 2021 at 10:40:49AM -0400, Matthew Miller wrote:
./modules/install-guide/pages/_partials/entities.adoc
I think from this we possibly could have a "fedora-docs-shared-entities" repo which would have definitions for these, pulled in as a remote content repository? https://docs.antora.org/antora/2.3/playbook/content-source-url/
On Mon, Oct 11, 2021 at 10:40:49AM -0400, Matthew Miller wrote:
Also: is there a way we can make parameterized macros? Like, something where we can say {CHATROOM:council}[Fedora Council] and it'll automatically link that to
https://matrix.to/#/#matrix-meta-chat:fedoraproject.org?web-instance%5Beleme...
So I found https://www.magnolia-cms.com/blog/tips-for-writing-antora-macros.html, which links back to a Fedora docs example. :)
Hah, nice :)
Yes, it should be possible, someone even suggested that before but it never went anywhere. We'll have to update every repo's site.yml to pull in the shared attributes during a local build, and include the entity file from the shared repo on top of each page so we can use the attributes on each page, but that shouldn't be too bad, it's a one-time effort basically.
I'll take a look at it after we release F35, I'll be pretty busy until then. Petr
On Mon, Oct 11, 2021 at 8:07 PM Matthew Miller mattdm@fedoraproject.org wrote:
On Mon, Oct 11, 2021 at 10:40:49AM -0400, Matthew Miller wrote:
Also: is there a way we can make parameterized macros? Like, something
where
we can say {CHATROOM:council}[Fedora Council] and it'll automatically
link
that to
https://matrix.to/#/#matrix-meta-chat:fedoraproject.org?web-instance%5Beleme... https://matrix.to/#/%23matrix-meta-chat:fedoraproject.org?web-instance%5Belement.io%5D=chat.fedoraproject.org
So I found https://www.magnolia-cms.com/blog/tips-for-writing-antora-macros.html, which links back to a Fedora docs example. :)
-- Matthew Miller mattdm@fedoraproject.org Fedora Project Leader _______________________________________________ docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
On Wed, Oct 13, 2021 at 03:39:31PM +0000, Petr Bokoc wrote:
I'll take a look at it after we release F35, I'll be pretty busy until then. Petr
Awesome thanks!
-
Matthew Miller -
Petr Bokoc