search

nemo-ufes / gufo

gUFO: A Lightweight Implementation of the Unified Foundational Ontology (UFO)
http://purl.org/nemo/doc/gufo
Creative Commons Attribution 4.0 International
24 stars 6 forks source link

Add BibTex entry to citation instructions #2

Closed claudenirmf closed 3 years ago

claudenirmf commented 3 years ago

The instructions for citing gUFO could include the BibTex entry as well, for example:

@misc{almeida2019gufo,
  title={{gUFO}: A lightweight implementation of the {Unified Foundational Ontology} ({UFO})},
  author={Almeida, Jo{\~a}o Paulo A. and Guizzardi, Giancarlo and Falbo, Ricardo Almeida and Sales, Tiago Prince},
  year={2019},
  howpublished={\url{http://purl.org/nemo/gufo}}
}

As far as I know, adding URLs nicely requires additional packages, so my example uses howpublished. The example also includes the publication year of gUFO, which is missing in the current citation instructions.

Just one additional observation: the deployed website and the latest commit do not match.

jpalmeida commented 3 years ago

Thanks, I added the year to the citation. However, the documentation is generated from comments in the ontology, so, I'd rather not add a BibTeX fragment to the ontology. It would require careful escaping and the rendering in different tools (including the generated html) might be problematic.

I checked the commit and the deployed website and did not find any differences. (In fact, http://purl.org/nemo/doc/gufo redirects to http://nemo-ufes.github.io/gufo/ which is served directly from the master.)

claudenirmf commented 3 years ago

I understand now the reason for the confusion, you are using the actual ontology to generate the documentation.