Create a CITATION.cff using cffinit#

cffinit is a web application which helps users create a CITATION.cff file. The application provides guidance for each field of the CFF schema and does the validation automatically. When there are issues, cffinit will provide a visual feedback on relevant fields.

In the following sections you can find details about each step of the process.

To get started, visit cffinit and click on the “Create” button to continue to the Start screen.

Landing page of cffinit.

Fig. 74 Landing page of cffinit. 1#

Start#

On the first page of the application, enter the title of your work, write a message to indicate how you want your software to be mentioned, and select whether you are creating a CITATION.cff file for software or a dataset.

First page of the application, for Title, Message and Type. Fields are empty.

Fig. 75 First page of the application, for Title, Message and Type. 1#

You can see the preview of the generated CITATION.cff file on the right.

If there are issues in any of the fields, they will be highlighted and error messages will be shown in red. When the generated CITATION.cff file is not valid, the preview widget will have a red border.

Note

As title, message and author are required fields by the schema, these fields will be highlighted until you provide them.

Click next to continue to the Authors screen.

First page of the form, for Title, Message and Type. Fields are filled.

Fig. 76 First page of the form, for Title, Message and Type. Fields are filled. 1#

Authors#

The CFF schema requires at least one author in the CITATION.cff file. Click the “Add author” button to open a form to do so. Fill the relevant fields for authors. Adding ORCID for authors is highly recommended. See ORCID to Collect your Research Objects to learn more about ORCID.

Second page of the form, for Authors.

Fig. 77 Second page of the form, for Authors. 1#

Second page of the form, for Authors. Author addition in progress.

Fig. 78 Second page of the form, for Authors. Author addition in progress. 1#

After adding one author, you have the minimum required information for a valid CITATION.cff file. Add more authors as needed. Click next afterwards to continue.

Second page of the form, for Authors. One author filled.

Fig. 79 Second page of the form, for Authors. One author filled. 1#

Minimal CITATION.cff file#

Well done! Now your CITATION.cff file meets the minimum requirements. In this screen you can download the generated file or copy it from the preview widget. We highly recommend that you add more information. Click the “Add more” button to add more fields to your citation file to make it even better.

Last page of the minimal form.

Fig. 80 Last page of the minimal form. 1#

Additional fields#

All additional fields are optional, but it is recommended that you fill the most relevant for your work.

Note

If you decide not to continue further, you can press the “Finish” button to skip all remaining steps and go to the final screen.

On this screen, you will see new steps in the stepper. Here is a brief description of the additional screens:

  • Identifiers: Add DOIs, URLs, and Software Heritage identifiers;

  • Related resources: URLs of repositories related to the work and its website;

  • Abstract: A short summary of the work;

  • Keywords: Keywords describing the work;

  • License: The license under which the work is available;

  • Version specific: Information about a specific release or commit, including the date of the release.

Third page of the form. More options appear on the left.

Fig. 81 Third page of the form. More options appear on the left. 1#

Click next to start adding additional fields.

Final screen#

Great that you made it to the final screen! After adding all the relevant information, you will have a validated CITATION.cff file. Download or copy it and add it to your public repository to get the credit you deserve!

Last page of the complete form.

Fig. 82 Last page of the complete form. 1#

1(1,2,3,4,5,6,7,8,9)

All screen captures in this section refer to cffinit v2.0.0.