JabRef / JabRef/user-documentation
Add CSL Styles to LibreOffice Documentation
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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