Hi all,
In the switch to Antora, a cross-linked reference to another document broke; I wanted to know what the correct way of cross-linking other documents in the same Pagure repository for a Fedora Docs project is.
The link that broke is found here:
https://docs.fedoraproject.org/en-US/commops/contribute/join/#first-steps
https://pagure.io/fedora-commops/blob/master/f/docs/modules/ROOT/pages/contr...
It seems to use the Antora xref syntax, but I wasn't sure why the cross-reference doesn't render correctly in production.
Thanks!
PS — Finally switched over all of our wiki pages today to point to Fedora Docs. Super excited to finally do this, thanks for the hard work everyone!!!
On Fri, Aug 10, 2018 at 7:04 AM, Justin W. Flory jflory7@gmail.com wrote:
Hi all,
In the switch to Antora, a cross-linked reference to another document broke; I wanted to know what the correct way of cross-linking other documents in the same Pagure repository for a Fedora Docs project is.
The link that broke is found here:
I submitted a PR to fix this.
https://pagure.io/fedora-commops/pull-request/172#
I am not sure why the full path is required ...
regards,
bex
https://docs.fedoraproject.org/en-US/commops/contribute/join/#first-steps
https://pagure.io/fedora-commops/blob/master/f/docs/ modules/ROOT/pages/contribute/join.adoc#_69
It seems to use the Antora xref syntax, but I wasn't sure why the cross-reference doesn't render correctly in production.
Thanks!
PS — Finally switched over all of our wiki pages today to point to Fedora Docs. Super excited to finally do this, thanks for the hard work everyone!!!
-- Cheers, Justin W. Flory jflory7@gmail.com
docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@lists. fedoraproject.org/message/AKWASJ7NYQEJBYWCDS56YPTZ2NL6BE6K/
Hi Brian and Adam I have some difficulty with PR definition. If I was the owner of a git repository, and I had emails or some form with an embedded document, I would do a pull to pull it into the git repository.But I am here 500 miles north of New York, in wonderful multicultural multilingual Montreal, and I want do do a push. I really think that *.adoc is a final output and that another approach is needed. I was a paid author and ERP engineer for the following site. News and Press Releases
| | | | News and Press Releases
|
|
|
We could never be able to produce accurate rapid output using an adoc file as a working document.If you think it is possible, then I say that you need to triple the work effort to produce an updated document for each new release. You are in the USA. I can call direct or you can call me when you have time.
Regards Leslie Leslie Satenstein Montréal Québec, Canada
On Wednesday, August 15, 2018, 1:41:40 p.m. EDT, Brian (bex) Exelbierd bexelbie@redhat.com wrote:
On Fri, Aug 10, 2018 at 7:04 AM, Justin W. Flory jflory7@gmail.com wrote:
Hi all,
In the switch to Antora, a cross-linked reference to another document broke; I wanted to know what the correct way of cross-linking other documents in the same Pagure repository for a Fedora Docs project is.
The link that broke is found here:
I submitted a PR to fix this. https://pagure.io/fedora-commops/pull-request/172# I am not sure why the full path is required ... regards, bex
https://docs.fedoraproject. org/en-US/commops/contribute/ join/#first-steps
https://pagure.io/fedora- commops/blob/master/f/docs/ modules/ROOT/pages/contribute/ join.adoc#_69
It seems to use the Antora xref syntax, but I wasn't sure why the cross-reference doesn't render correctly in production.
Thanks!
PS — Finally switched over all of our wiki pages today to point to Fedora Docs. Super excited to finally do this, thanks for the hard work everyone!!!
I've commented in the PR — it's the path under the "pages" directory. See the PR for a full explanation: https://pagure.io/fedora-commops/pull-request/172#
On Wed, Aug 15, 2018 at 7:41 PM Brian (bex) Exelbierd bexelbie@redhat.com wrote:
On Fri, Aug 10, 2018 at 7:04 AM, Justin W. Flory jflory7@gmail.com wrote:
Hi all,
In the switch to Antora, a cross-linked reference to another document broke; I wanted to know what the correct way of cross-linking other documents in the same Pagure repository for a Fedora Docs project is.
The link that broke is found here:
I submitted a PR to fix this.
https://pagure.io/fedora-commops/pull-request/172#
I am not sure why the full path is required ...
regards,
bex
https://docs.fedoraproject.org/en-US/commops/contribute/join/#first-steps
https://pagure.io/fedora-commops/blob/master/f/docs/modules/ROOT/pages/contr...
It seems to use the Antora xref syntax, but I wasn't sure why the cross-reference doesn't render correctly in production.
Thanks!
PS — Finally switched over all of our wiki pages today to point to Fedora Docs. Super excited to finally do this, thanks for the hard work everyone!!!
-- Cheers, Justin W. Flory jflory7@gmail.com
docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/m...
-- Brian (bex) Exelbierd | bexelbie@redhat.com | bex@pobox.com Fedora Community Action & Impact Coordinator @bexelbie | http://www.winglemeyer.org _______________________________________________ docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/m...