Blog post: CSL4LibreOffice #97
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,65 @@ | ||
| --- | ||
| title: JabRef's new CSL Integration for LibreOffice | ||
| tags: [gsoc, csl] | ||
| author: subhramit | ||
| --- | ||
|
|
||
| Hi, I am Subhramit. I am a Google Summer of Code (GSoC) student at JabRef this year, and I'll be walking you through JabRef's new CSL Integration for LibreOffice. | ||
|
|
||
| ## Background | ||
|
|
||
| As a student, I first came across pre-defined citation formats during my freshman year of college, when our professor instructed that the references in our project report must follow the "APA style". | ||
|
|
||
| I remember manually generating and copying citations in that style from some citation generation website, and oh was it tedious. Whether you are a student like me or a seasoned researcher in academia, you must have grappled with various citation styles throughout your academic journey. | ||
|
|
||
| [Citation Style Language](https://citationstyles.org/) (CSL) is a popular open-source specification language that standardizes the formatting of citations and bibliographies. It supports thousands of standard citation styles used in academia, including *American Psychological Association* (APA), *Modern Language Association* (MLA), *Chicago Manual of Style* (CMS), *Institute of Electrical and Electronics Engineers* (IEEE), *Springer - Lecture Notes in Computer Science* and *Vancouver* to name a few. If you've ever cited a source in an academic paper, chances are you've used a CSL-based style. | ||
|
There was a problem hiding this comment. Citation Style Language (CSL) is a popular open-source specification language that standardizes the formatting of citations and bibliographies. It supports thousands of standard citation styles used in academia, including American Psychological Association (APA), Modern Language Association (MLA), Chicago Manual of Style (CMS), Institute of Electrical and Electronics Engineers (IEEE), Springer - Lecture Notes in Computer Science and Vancouver to name a few. If you've ever cited a source in an academic paper, chances are you've used a style that is supported by the CSL community and its specification. |
||
|
|
||
| For several years, JabRef users have been requesting support for CSL in its LibreOffice integration. Tackling this problem statement this summer as a part of my project, I am excited to announce that this highly anticipated feature is now available! | ||
|
|
||
|
|
||
| ## What's New? | ||
|
|
||
| With this integration, JabRef users can now: | ||
|
|
||
| 1. **Choose a CSL Style**: Select from a vast array of CSL styles to match the requirements of your academic work. | ||
|
|
||
| 2. **Cite with Flexibility**: Insert citations as well as in-text citations (similar to LaTeX's `\cite` and `\citet` commands) directly into your LibreOffice document. | ||
|
There was a problem hiding this comment. "Insert usual citiations"... It reads strange that no attribute for "citations" first, but we have no word for "non-intext.citations", do we? Replace "LaTeX's" by "natbib's" and link https://ctan.org/pkg/natbib. There was a problem hiding this comment. "Usual citations" sounds odd. Plus, "usual" can have wide connotation till the reader gets to the natbib part. There was a problem hiding this comment. If not this, the other alternative - "insert citations directly into..." (remove in-text, as citations is generic and can encompass all types). There was a problem hiding this comment.
Does not solve the issue that for the first, there is no adjective. - @thilote is the text for you Ok or should we just remove "in-text" and natbib completely? There was a problem hiding this comment. I think Thilo isn't tagged properly so @ThiloteE There was a problem hiding this comment. Which sentence, Thilo? There was a problem hiding this comment. I am not sure what case 1 or case 2 are. Ideally, I would prefer splitting up Cite and Cite-in-Text into separate sections, but it's fine, if that is explained more in detail in the documentation. There was a problem hiding this comment. Can you check if the current sentence is okay? Or if I should revert it and bring back the distinctions and natbib refrences? (Reason was to make it more readable to a wider audience, including those who don't use LaTeX). There was a problem hiding this comment. To be honest, I don't have a strong opinion here. Your choice :-) There was a problem hiding this comment. Alright. |
||
| 3. **Auto-generate Bibliographies**: Watch as your bibliography automatically populates based on your citations, with just a single click. | ||
| 4. **Update Bibliographies**: Easily refresh your bibliography as you add new citations to your document. | ||
|
|
||
| ## Getting Started | ||
|
|
||
| To start using this new feature: | ||
|
|
||
| 1. Update to the latest version and start JabRef | ||
subhramit marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| 2. Connect to a running LibreOffice document instance from the OpenOffice Panel | ||
subhramit marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| 3. Click on "Select style" from the panel | ||
|
|
||
| 4. Choose your preferred CSL style from the list and click OK | ||
|
There was a problem hiding this comment.
|
||
| 5. Select an entry (or a group of entries) and click "Cite" to insert citations into the document | ||
|
There was a problem hiding this comment.
|
||
| 6. Click on the "Make/Sync bibliography" on the panel to auto-generate a bibliography section in your document based on your citations and the selected CSL style | ||
|
There was a problem hiding this comment. Press the "Make/Sync bibliography" button to auto-generate a bibliography section in your document based on your citations and the selected CSL style. |
||
|
|
||
| ### Demo | ||
|
|
||
| #### Selecting a style | ||
|
|
||
|  | ||
|
|
||
| #### Inserting citations | ||
|
|
||
|  | ||
|
|
||
| #### Generating bibliography | ||
|
|
||
|  | ||
|
|
||
| #### Updating bibliography | ||
|
|
||
|  | ||
|
|
||
| ## Summary | ||
|
|
||
| We hope this new feature enhances your research and writing process. As always, we welcome your feedback and suggestions for further improvements. | ||
subhramit marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| This CSL integration is a direct result of working on valuable user feedback, addressing long-standing feature requests ([#119](https://github.com/JabRef/jabref/issues/119) and [#2146](https://github.com/JabRef/jabref/issues/2146) on our GitHub). | ||
|
|
||
| If you are interested in the technical details of how this project was undertaken, do check out the [wiki](https://github.com/JabRef/jabref/wiki/GSoC-2024-%E2%80%90-Improved-CSL-Support-%28and-more-LibreOffice%E2%80%90JabRef-integration-enhancements%29). | ||
|
|
||
| Happy citing! | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I remember manually generating and copying citations in that style from a citation generation website, and oh was it tedious. Whether you are a student like me or a seasoned researcher in academia, you must have grappled with various citation styles throughout your academic journey.