Athanasios Katsadas (17d3c36d) at 08 Nov 09:41
Update README.md
Hi, I'm a colleague of Rieks from TNO. There is a wish to support referencing external terms (i.e. contained in a different docusaurus project). There are also some issues with the current implementation of the glossary/terminology plugin.
Currently the plugin does what is essentially a grep+replace of %%term|term%%
combinations. It then hardcodes <Term />
react components into the resulting MDX and actually overwrites the source files in the docusaurus project.
This is problematic for a couple of reasons. First of all, only after compiling/parsing a markdown document for terms, you can actually see the result of adding terms to your document. During writing/development, you will only see %%blah|blah%%
which does not exactly help with the speed of feedback. You need to commit, parse, check output, rollback during development, which is not an ergonomic process.
I agree with issue #4 that the syntax is also rather obscure.
I think a different approach could remove a lot of current code, and make the whole process of term definition simpler.
[my text](%term)
. This would mean we can use existing markdown parsing capabilities of docusaurus/remark instead of writing our own. Using the existing syntax could be achieved by extending the remark markdown syntax, but it would require some extra work.<Term label="my-term">My text here</Term>
. This means we do not need to put information fetch logic into the markdown parser/transformer.my-term
to the actual hover text and a link to the term page.This information would need to come from somewhere. I have not yet investigated the glossary generation all too much. I'll have another look and update this issue once I have a better idea of what would be possible here.
Athanasios Katsadas (099c9706) at 01 Jun 09:11
v1.3.0
Athanasios Katsadas (b009f030) at 01 Jun 09:11
v1.3.0
Maria Iliadi (7477bb48) at 01 Jun 09:08
Athanasios Katsadas (7477bb48) at 01 Jun 09:07
Add test and description on README
... and 1 more commit
Maria Iliadi (7477bb48) at 25 May 10:50
Add test and description on README
Maria Iliadi (2809bb61) at 20 May 14:07
Add glossaryTermPatterns option to filter terms by type in glossary
Maria Iliadi (38a659b8) at 20 May 08:52
Athanasios Katsadas (38a659b8) at 20 May 08:52
Update website example to latest docusaurus version
Maria Iliadi (38a659b8) at 11 May 11:04
Update website example to latest docusaurus version
Athanasios Katsadas (e1ee327f) at 10 May 15:11
v1.2.1
Athanasios Katsadas (98cb1574) at 10 May 15:11
v1.2.1
Athanasios Katsadas (b61fe8a1) at 10 May 15:10