How to add hyperlinks to a document's internal sections
Dear all,
We are creating content in markdown and we came across an issue while trying to add hyperlinks to a document's internal sections. When in Markdown the hyperlink works but in the portal it stops working.
[Cuando se trate de la descarga de una consulta de datos](#Cuando-se-trate-de-la-descarga-de-una-consulta-de-datos)
For example: when in the Markdown Github preview we can click on the hyperlink...
....and It redirects to the respective title/section within the same document:
( https://github.com/gbif/hp-colombian-biodiversity/blob/master/recursos/ComoC... )
But in the portal we get a dead link:
( https://hp-colombian-biodiversity.gbif-staging.org/recursos/ComoCitar#Cuando... )
Then, Which is the correct way to address hyperlinks to a document's internal sections?
Thank you in advance,
Hi Camilla,
Could you try using the syntax below if it works?[https://forms.gle/S1vo53AU9LUSip4h9%5D(https://forms.gle/S1vo53AU9LUSip4h9)
regards,
Wayne
From: Hosted-Portals hosted-portals-bounces@lists.gbif.org On Behalf Of Camila Andrea Plata Corredor Sent: Wednesday, 24 February 2021 3:02 PM To: hosted-portals@lists.gbif.org Subject: [Hosted-Portals] How to add hyperlinks to a document's internal sections
Dear all,
We are creating content in markdown and we came across an issue while trying to add hyperlinks to a document's internal sections. When in Markdown the hyperlink works but in the portal it stops working.
[Cuando se trate de la descarga de una consulta de datos](#Cuando-se-trate-de-la-descarga-de-una-consulta-de-datos)
For example: when in the Markdown Github preview we can click on the hyperlink...
[https://lh3.googleusercontent.com/L4BIFaUl6RwJWZip6KP2IkpNirV0WbMlZ_NnE006KN...]
....and It redirects to the respective title/section within the same document:
(https://github.com/gbif/hp-colombian-biodiversity/blob/master/recursos/ComoC...)
[https://lh6.googleusercontent.com/VYcAupr6YoRymmLw6rbm-GIJFv1wmrz778DcsyT_0z...]
But in the portal we get a dead link:
(https://hp-colombian-biodiversity.gbif-staging.org/recursos/ComoCitar#Cuando...)
[https://lh3.googleusercontent.com/XxmQ7e1_LIqsFl0vQigaiicyvBeOQOtJ60N6dWkkcC...]
Then, Which is the correct way to address hyperlinks to a document's internal sections?
Thank you in advance,
-- Camila Andrea Plata Corredor Equipo Coordinador Sistema de Información sobre Biodiversidad de Colombia
Anchors - or internal links are automatically generated.
In your particular case the issue is casing works: https://hp-colombian-biodiversity.gbif-staging.org/recursos/ComoCitar#cuando... Do not work: https://hp-colombian-biodiversity.gbif-staging.org/recursos/ComoCitar#Cuando...
Github vs Kramdown The problem is that markdown isn't one thing. And you just stumbled over a difference in how Github do it and how Kramdown (the Jekyll markdown parser) do it. So you cannot copy anchors from one to the other as the 2 generate them differently.
You can read a bit about the default Kramdown settings on the Jekyll docshttps://jekyllrb.com/docs/configuration/markdown/ - (they call it header ID generation)
The flavor of markdown used on the website is described on the base themehttps://hp-base-theme.gbif-staging.org/markdown - including links to the kramdown documentationhttps://kramdown.gettalong.org/quickref.html. Notice that you can control the anchor text. You can also add a table of content by adding "toc: true" to your front matter.
Hope that helps Morten ________________________________ From: Hosted-Portals hosted-portals-bounces@lists.gbif.org on behalf of Wayne Asera waynea@sprep.org Sent: Wednesday, February 24, 2021 2:50 AM To: Helpdesk, discussion and announcements for the GBIF hosted portals hosted-portals@lists.gbif.org Subject: Re: [Hosted-Portals] How to add hyperlinks to a document's internal sections
Hi Camilla,
Could you try using the syntax below if it works?[https://forms.gle/S1vo53AU9LUSip4h9%5D(https://forms.gle/S1vo53AU9LUSip4h9)
regards,
Wayne
From: Hosted-Portals hosted-portals-bounces@lists.gbif.org On Behalf Of Camila Andrea Plata Corredor Sent: Wednesday, 24 February 2021 3:02 PM To: hosted-portals@lists.gbif.org Subject: [Hosted-Portals] How to add hyperlinks to a document's internal sections
Dear all,
We are creating content in markdown and we came across an issue while trying to add hyperlinks to a document's internal sections. When in Markdown the hyperlink works but in the portal it stops working.
[Cuando se trate de la descarga de una consulta de datos](#Cuando-se-trate-de-la-descarga-de-una-consulta-de-datos)
For example: when in the Markdown Github preview we can click on the hyperlink...
[https://lh3.googleusercontent.com/L4BIFaUl6RwJWZip6KP2IkpNirV0WbMlZ_NnE006KN...]
....and It redirects to the respective title/section within the same document:
(https://github.com/gbif/hp-colombian-biodiversity/blob/master/recursos/ComoC...)
[https://lh6.googleusercontent.com/VYcAupr6YoRymmLw6rbm-GIJFv1wmrz778DcsyT_0z...]
But in the portal we get a dead link:
(https://hp-colombian-biodiversity.gbif-staging.org/recursos/ComoCitar#Cuando...)
[https://lh3.googleusercontent.com/XxmQ7e1_LIqsFl0vQigaiicyvBeOQOtJ60N6dWkkcC...]
Then, Which is the correct way to address hyperlinks to a document's internal sections?
Thank you in advance,
--
Camila Andrea Plata Corredor
Equipo Coordinador Sistema de Información sobre Biodiversidad de Colombia
participants (3)
-
Camila Andrea Plata Corredor
-
Morten Høfft
-
Wayne Asera