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

Changed t2t files to markdown (md) files #144

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

nemoyjh
Copy link

@nemoyjh nemoyjh commented Aug 11, 2022

t2t Files were changed to md files using text2tags.

@inariksit
Copy link
Member

Thanks for the initiative @nemoyjh! I have some concern for backwards-compatibility, because links in a TOC generated from the t2t files is different from TOC generated from markdown. Example:

http://www.grammaticalframework.org/doc/gf-video-tutorials.html#general-introduction-to-gf
— link is the name of the subheading. This page was written as a markdown file from the beginning.

http://www.grammaticalframework.org/doc/gf-shell-reference.html#toc8 — link is the word toc + a number.

The thing I'm worried about is that some resources have linked these pages with #tocN and those links are now broken. I can change of course all references from my blog, my StackOverflow answers and on the GF website, but I wonder if there are other sources where those links can't be changed, like the gf-dev mailing list.

@anka-213
Copy link
Member

anka-213 commented Oct 4, 2022

It might be possible to manually insert anchors with the old names into the markdown. Something like this might work:

#### <a name="toc8"></a> cc = compute_concrete 

See this stackoverflow question for more details:
https://stackoverflow.com/questions/5319754/cross-reference-named-anchor-in-markdown

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

Successfully merging this pull request may close these issues.

3 participants