↓Aller au contenu
  1. Documentation/

Adding publications

2 mins
Sommaire

Basics #

A page listing publications can be created and customized by creating or editing a directory in your content directory and adding a file named _index.md in that directory. Beware that the _ prefix to the file name is important for Hugo to consider this page as an index page. For instance, for this example site, we have a file content/publications/_index.md. to setup this page for displaying publications, the front matter of your _index.md should contain the key:

contentType: publication

Publications should be listed as markdown files in your directory. They are not actually meant to be manually added. You should probably use import scripts to list them from the LIRIS database, which relies on HAL. If some publications are missing, you should first check that these are properly available on HAL with proper affiliation. Manual edition should only be used to fix data that cannot be fixed otherwise. The current layout file supposes that a publication has a record on HAL, and will exhibit broken links if this is not the case. For instance, a link to the bibtex entry is automatically added based on the params/externalUrl field. Since this example site exhibits fake publications, their links are broken or misleading.

Publication thumbnails have a default neutral image, but can be customized by adding an image file named after the hal id of the publication. The thumbnail file name can also be manually specified in the markdown file front matter

---
thumbnail: image-filename.png
---

Merging with imported content #

Imported content can be manually overridden by using a file with the same name as the imported one in the content/publications directory. Import scripts use the hal identifier for the file name by default. The Publication layout file currently supports additional fields that cannot be imported :

  • params/code to provide a link to a code repository
  • params/video to provide a link to a video

Beware that customizing the params/externalUrl field will break the bibtex link generated for the paper. If you do so, you should also provide a params/bibtex field with either a custom url to the bibtex entry or false to deactivate the bibtex entry as in the example below.

---
externalURL: https://example.com
params:
  bibtex: false
---