Allow user to choose CSL Bibliography title and format

[subhramit]

This is a "contextual" introductory issue for people wanting to dive into JabRef's LibreOffice integration.
It is a small/medium-sized task with the overall difficulty of a good third or fourth issue.

Context

Pre-requisites

Refer to this blog article for an introduction to how CSL styles are used with JabRef's LibreOffice integration.

Issue

Currently, we have a hardcoded default title and its paragraph format for the CSL Bibliography as given in CSLFormatUtils:

jabref/src/main/java/org/jabref/logic/openoffice/oocsltext/CSLFormatUtils.java

Lines 28 to 30 in 20dbba5

	// TODO: These are static final fields right now, should add the functionality to let user select these and store them in preferences.
	public static final String DEFAULT_BIBLIOGRAPHY_TITLE = "References";
	public static final String DEFAULT_BIBLIOGRAPHY_HEADER_PARAGRAPH_FORMAT = "Heading 2";

We wish to provide flexibility to users such that they can set a different title for the list of references (e.g. "Bibliography", or some other word/phrase in English or other languages) as well as choose its formatting.

The current workaround is that the user manually modifies it themselves once all their work is over - as otherwise the title will get reset every time the bibliography is refreshed (due to addition/deletion/rearrangement of citations, or manual trigger).

In case of JStyles, this problem does not exist as they are custom styles, and the user can provide their intended values when making the .jstyle file:

jabref/src/main/resources/resource/openoffice/default_authoryear.jstyle

Lines 10 to 15 in 20dbba5

	PROPERTIES
	Title="References"
	IsSortByPosition="false"
	IsNumberEntries="false"
	ReferenceParagraphFormat="Text body"
	ReferenceHeaderParagraphFormat="Heading 2"

Task

1. Add an option in the "CSL Styles" tab of the "Select Style" window (in the OpenOffice/LibreOffice Panel) to "modify bibliography title". On clicking that, the user should be given options to set the text for the title and its format

   

   • The options for format should be available via a dropdown, and should consist of the popular presets in paragraph style formatting options as available in LibreOffice:

     
     The mechanism to apply the formatting does not need to be written, as it is already present. Just specifying the format name is enough. The default (if unchanged), however, should still remain "Heading 2".

2. These settings should be saved as user preferences in OpenOfficePreferences.

Test for completion

• The specified text should be rendered as the bibliography title on generating bibliography via CSL styles.
• The options should be stored across JabRef sessions.

[IvanPetkov23]

/assign-me

[github-actions]

👋 Hey @IvanPetkov23, thank you for your interest in this issue! 🎉

We're excited to have you on board. Start by exploring our Contributing guidelines, and don't forget to check out our workspace setup guidelines to get started smoothly.

In case you encounter failing tests during development, please check our developer FAQs!

Having any questions or issues? Feel free to ask here on GitHub. Need help setting up your local workspace? Join the conversation on JabRef's Gitter chat. And don't hesitate to open a (draft) pull request early on to show the direction it is heading towards. This way, you will receive valuable feedback.

Happy coding! 🚀

⏳ Please note, you will be automatically unassigned if the issue isn't closed within 45 days (by 24 April 2025). A maintainer can also add the "📌 Pinned"" label to prevent automatic unassignment.

[IvanPetkov23]

/unassign-me