Home

This repository contains a JavaScript module that simplifies the integration of an author's HAL bibliography into a website. The code uses the HAL API to retrieve data and displays it in a style similar to the HAL CV. The package also provides several plugins to enhance the displayed information.

Configure the module

The module is configured through a single global JavaScript object:

const hal_bibliography_integrator_conf = { ... };

This object controls what data is fetched from HAL, how it is displayed, and the plugins' behavior.

const hal_bibliography_integrator_conf = {
    id: "idHal",  
    typeList: [
        "THESE",
        "ART",
        "PROCEEDINGS",
        "UNDEFINED",
        "COMM"
    ],
    doit: true,
    debug: false,
    onLoad: "expanded",
    plugins: {},
};

Options

id (string, required): HAL author identifier used to fetch publications.
typeList (array of strings, required): Defines which document types should be included in the output. Available values are described in the table below
doit (boolean, optional): Controls whether the module executes automatically.
- true → the module fetches and renders data immediately on load
- false → prevents automatic execution
debug (boolean, optional): Enables verbose logging in the browser console.
onLoad (string, optional): Defines the default UI state of publication sections when rendered. Accepted values:
- expanded → all sections are open by default
- collapsed → all sections are closed by default
plugins (object, optional): Configure module's plugins. See their specific documentation.

Supported HAL publication types

The table below provides the keywords to use in the typeList key to retrieve the full list of publications of a given type. The last column indicates whether the type is supported by the JavaScript module:

Keyword	Description 🇬🇧	Description 🇫🇷	Supported Pris en charge
ART	Journal article	Article de journal	✔️
COMM	Conference paper	Communication dans un congrès	✔️
COUV	Book chapter	Chapitre de livre	✔️
THESE	PhD thesis	Thèse	✔️
OUV	Book	Livre	✔️
UNDEFINED	Preprint	Preprint, document de travail	✔️
REPORT	?	?	❌
OTHER	?	?	❌
MEM	?	?	❌
IMG	Image	Image	❌
POSTER	Conference poster	Poster de conférence	✔️
ISSUE	?	?	❌
PROCEEDINGS	Proceedings	Proceedings	✔️
HDR		Habilitation à diriger des recherche	❌
NOTICE	?	?	❌
PATENT	Patent	Brevet	✔️
BLOG	?	?	❌
REPORT_LABO	?	?	❌
VIDEO	Video	Vidéo	❌
REPORT_MAST	?	?	❌
LECTURE	Lesson	Cours	✔️
REPORT_LPRO	?	?	❌
REPORT_LICE	?	?	❌
TRAD	?	?	❌
SOFTWARE	Software	Logiciel	✔️
CREPORT	?	?	❌
PRESCONF	?	?	❌
REPORT_DOCT	?	?	❌
REPORT_ETAB	?	?	❌
MAP	?	?	❌
SON	?	?	❌
REPORT_FORM	?	?	❌
REPORT_GMAST	?	?	❌
OTHERREPORT	?	?	❌
NOTE	?	?	❌
SYNTHESE	?	?	❌
REPORT_FPROJ	?	?	❌
REPORT_GLICE	?	?	❌
REPACT	?	?	❌
MEMLIC	?	?	❌
REPORT_RFOINT	?	?	❌
REPORT_COOR	?	?	❌
ETABTHESE	?	?	❌
REPORT_RETABINT	?	?	❌
MANUAL	?	?	❌
DOUV	?	?	❌