-
Notifications
You must be signed in to change notification settings - Fork 9
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
Terminology Design tools integration #177
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Changes seem ok.
What should be blocking for merge is that we do not yet have a HRG generated, so merging it to the eSSIF-Lab repo would mean that people browsing the site would no longer see a glossary. So we should wait until either we have a version of the glossary that we can use and publish from the repo, or there is an HRGT that would generate one.
I've added the first version of the HRGT to my fork. Please have a look https://ca5e.github.io/framework/docs/essifLab-glossary. Merging should be possible. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I have modified the MRGRef tag spec to reflect that converter="<converter>"
is optional. Of course, if it is omitted, that would imply that it be specified either on the command-line or in the configuration file (as is currently done). It gets rid of the 'ugly' converter=""
text.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it may be useful to keep a simplified version as the default for using essiflab
as the converter value.
So when using {% hrg="" converter="essiflab" %}
.
We get:
### [{{glossaryTerm}}]({{navurl}})\n
{{glossaryText}}\n
Instead of the more complex converter that's actually used:
### [{{#if glossaryTerm}}{{glossaryTerm}}{{else}}{{capFirst term}}{{/if}}]({{localize navurl}})\n
{{#if glossaryText}}{{glossaryText}}{{else}}no `glossaryText` was specified for this entry.{{/if}}\n
This relates to writing the documentation for the HRGT and giving certain converter examples mainly. I suspect it might be more user friendly if we keep the essiflab default simple and explain the more complex one separately.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok to keep simple stuff in the tev2-specifications, but it may help them there to see examples from 'real life'.
docs/terms/identify.md
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please make sure that when texts are encountered that would not work, they somehow get logged with messages that help curators to fix the problem. (I cannot tell whether or not they currently are).
I've compared the changes in my fork to the master branch instead of the use-tev2 branch as I saw some work already being done on removing TEv1 documentation within the master branch.
Although deployment is done quite differently compared to before, I believe these changes should work with the current setup of the framework repository. My deployment (fork) can be seen here https://ca5e.github.io/framework/docs/essifLab.