Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Blog post: CSL4LibreOffice #97

Merged
merged 19 commits into from
Aug 26, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions _data/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,16 +11,20 @@ houssem:
url: https://github.com/HoussemNasri

ruslan:
name: Ruslan
name: Ruslan
url: https://github.com/InAnYan

david:
name: David
name: David
url: https://github.com/davidemdot

teertinker:
name: Felix Wilke
url: https://github.com/teertinker

subhramit:
name: Subhramit Basu
url: https://github.com/subhramit

mentee:
name: JabRef GSoC Mentee
name: JabRef GSoC Mentee
64 changes: 64 additions & 0 deletions _posts/2024-08-26-GSoC-CSL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
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](https://summerofcode.withgoogle.com/programs/2024/projects/MfPL66UW) this year, and I will 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 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.

[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 style that is supported by CSL.

For several years, JabRef users have been requesting support for CSL in JabRef's 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:

- **Choose a CSL Style**: Select from a vast collection of CSL styles to match the requirements of your academic work.
- **Cite with ease**: Insert citations directly into your LibreOffice document.
- **Auto-generate Bibliographies**: Watch as your bibliography automatically populates based on your citations, with just a single click.
- **Update Bibliographies**: Easily refresh your bibliography as you add new citations to your document.

## Getting Started

To start using this new feature:

1. Download the [development version of JabRef](https://builds.jabref.org/main/).
2. Connect to a running LibreOffice document instance by either clicking the "Connect" or the "Manual Connect" button in the [Libre/OpenOffice Panel](https://docs.jabref.org/cite/openofficeintegration) in the side pane.
3. Click on "Select style".
4. Choose your preferred CSL style from the list and click "OK".
5. Select an entry (or a group of entries) and click the "Cite" button to insert citations into the document.
6. Click 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

![Selecting a style](../img/selecting-a-style.gif)

#### Inserting citations

![Inserting citations](../img/cite.gif)

#### Generating bibliography

![Generating bibliography](../img/bibliography.gif)

#### Updating bibliography

![Updating bibliography](../img/refresh.gif)

## Summary

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 JabRef's GitHub page).

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).

I hope this new feature enhances your research and writing process. As always, [feedback and suggestions for further improvements](https://discourse.jabref.org/c/feedback/3) are welcome.

Happy citing!
Binary file added img/bibliography.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/cite.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/refresh.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/selecting-a-style.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.