JabRef / JabRef/user-documentation

Add CSL Styles to LibreOffice Documentation

Open
#509 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
CSS
Stars
54
Forks
142
Avg merge
23h 56m
Merged PRs (30d)
12

Description

  • Using CSL-Styles and JStyles at the same time in one document.: See https://github.com/JabRef/jabref/pull/11712#issuecomment-2335546890

    I tested this PR. The only way that I found how to destroy its functionality was to select a numeric CSL style, to cite / cite-in-text and then to select the default numeric JStyle and cite / cite-in-text and then to delete some of the priorly cited references. Then pressed "Make/Sync Bibliography". This caused the JStyle reference list at the end of the document to update, but the CSL Style reference list to remain unchanged.

    Hey, thanks for trying out. Yes, the jstyle and csl style citation detection, parsing, bibliography section population and syncing pipelines are completely independent of each other and can't be (or rather isn't recommended to be) used together (one of the reasons being the reference mark format being different - Jstyles don't start with "JABREF_" as you may have noticed with csl). After working with jstyles, if you switch back to a csl style and press refresh, the bibliography for csl would update again, keeping the jstyle section independent in that case (i mean to say behavior is symmetrical the other way around as well).

    I think it would be good to add this piece of information to the documentation. It is an edge case and not many people will use both csl and jstyle in one document, but when they do, they will run into this.

  • "We also need to add the information on how to make reference marks visible in the user documentation."

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the LibreOffice documentation section covering CSL styles and reference marks. Add the documented behavior that CSL and JStyle bibliographies are independent when used together, including the refresh behavior described in the issue, and explain how to make reference marks visible. Done when both checklist items are covered.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.