Reference page

[maxim-belkin]

Reference page is used frequently in all episodes, so it might make sense to create a variable for it. Where can we do that and what should we call it?

CC @fmichonneau @rgaiacs

[fmichonneau]

that would be useful. A possible issue that would limit its use is that I don't think it's possible to combine markdown variables and anchors (i.e., [foo][reference-page]#foo doesn't work).

[maxim-belkin]

If we create a variable (e.g. reference_page), we would then be able to do things like:

[assign]({{ reference_page }}#assign) 

I did this in my local copy of python-novice-inflammation but I did this in the episode file itself. That's why I asked about where to create it (this variable) and what to call it.

[fmichonneau]

A Jekyll variable makes sense. It seems that adding it to links.md would be a natural fit. Would it work there? I think reference_page works well as a name for this.

[maxim-belkin]

It doesn't work if it is included in links.md and links.md included at the end of the episode file...

[fmichonneau]

Could we move links.md at the top of the pages? and even put the include statement in one of the _layouts (base.html?) so maintainers don't have to manually include it in each file?

[maxim-belkin]

Could we move links.md at the top of the pages?

Yes. We would have to update the check that requires this statement to be at the end of the file (this is easy).

and even put the include statement in one of the _layouts (base.html?) so maintainers don't have to manually include it in each file?

I don't think we can include the content of links.md in HTML files in _layouts folder becase {{ content }} there is already in HTML form. We'll have to look deeper into how to append the content of links.md to every file.

I glanced at the usage of links.md in swcarpentry/python-novice-inflammation and... none of the episodes actually uses any of the links defined in links.md.

I then looked at all of the lessons, and none of the links defined in links.md are used in SWC lesson except for:

• jupyter (in python-novice-gapminder in 01-run-quit.md)
• pandoc (in r-novice-inflammation in 07-knitr-R.md)
• rstudio (in git-novice in 14-supplemental-rstudio.md)
• swc-lessons (in r-novice-inflammation in 06-best-practices-R.Rmd)

I did not parse data/lib carpentry's lessons.