Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modularizar enlaces y referencias #31

Open
Alxe opened this issue Oct 6, 2019 · 4 comments
Open

Modularizar enlaces y referencias #31

Alxe opened this issue Oct 6, 2019 · 4 comments

Comments

@Alxe
Copy link
Contributor

Alxe commented Oct 6, 2019

Como este repositorio es un trabajo evolutivo en tiempo (cada curso escolar), recomendaría adaptar los enlaces de los archivos Markdown de "enlace inmediato" a "enlace referenciado", es decir:

# "Enlace inmediato"
Los criterios generales que figuran en la [guía docente](***) son los siguientes

# "Enlace referenciado"
Los criterios generales que figuran en la [guía docente][***] son los siguientes
···
···
[guia-docente]: ***

Esto permitiría definir los enlaces en un lugar más apropiado, como sea el final de la sección o capítulo, así como más fácil mantenerlos actualizados.

Para más información, consulta la documentación de CommonMark, un intento de estandarizar Markdown.

@JJ
Copy link
Owner

JJ commented Oct 6, 2019

Pero ¿GitHub sigue ese estándar?

@JJ
Copy link
Owner

JJ commented Oct 6, 2019

No estoy seguro que haya enlaces que se repitan, también... Sí puede haberlos en otros temas que no son exactamente con fecha, sino simplemente muchas referencias al mismo sitio.

@Alxe
Copy link
Contributor Author

Alxe commented Oct 6, 2019

Pero ¿GitHub sigue ese estándar?

Es algo más complejo que eso, CommonMark sigue el "flavour" de GitHub (además de otros) y procura estandarizarlo de forma que exista una referencia bien explícita para desarrollar herramientas que entiendan Markdown. Véase este artículo del blog y este documento de GitHub, que es el Spec de CommonMark con las extensiones de GitHub.

No estoy seguro que haya enlaces que se repitan, también... Sí puede haberlos en otros temas que no son exactamente con fecha, sino simplemente muchas referencias al mismo sitio.

Indiferentemente de si se repite o no, si usases "link labels" podrías estructurar mejor el documento, facilitando la lectura a la hora de verlo en texto plano. Como bonus adicional, es que puedas usar la misma referencia en varios enlaces.

@JJ
Copy link
Owner

JJ commented Oct 6, 2019 via email

@Alxe Alxe mentioned this issue Oct 7, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants