Blog post: CSL4LibreOffice #97

subhramit · 2024-08-23T01:52:34Z

Refs https://github.com/JabRef/jabref/wiki/GSoC-2024-%E2%80%90-Improved-CSL-Support-(and-more-LibreOffice%E2%80%90JabRef-integration-enhancements)

_posts/2024-08-23-GSoC-CSL.md

Co-authored-by: Oliver Kopp <[email protected]>

koppor · 2024-08-24T13:59:18Z

_posts/2024-08-23-GSoC-CSL.md

+
+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, [we welcome your feedback and suggestions for further improvements](https://discourse.jabref.org/c/feedback/3).


Use passive voice in second part. "We" sounds strange, b/c all other parts are "I". Since you also welcome feedback too I suggest passive voice

Change to passive voice

koppor

The more one reads, the more ideas one has 😅

koppor · 2024-08-25T06:53:53Z

_posts/2024-08-23-GSoC-CSL.md

+
+[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.
+
+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!


its --> JabRef's

koppor · 2024-08-25T06:55:20Z

_posts/2024-08-23-GSoC-CSL.md

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


array? Maybe "collection"?

koppor · 2024-08-25T06:56:57Z

_posts/2024-08-23-GSoC-CSL.md

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


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

"Usual citations" sounds odd. Plus, "usual" can have wide connotation till the reader gets to the natbib part.
How about this ^ (check changes).

If not this, the other alternative - "insert citations directly into..." (remove in-text, as citations is generic and can encompass all types).

~~Then also remove link to natbib, because there is no distinction any more~~

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?

I think Thilo isn't tagged properly so @ThiloteE

Which sentence, Thilo?
Your suggestion would be to remove mentioning natbib (or LaTeX) altogether?
Are you referring to case 1, case 1 with natbib removed, or case 2?

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.
The way it is now with natbib is ok. We have many LaTeX users, so Natbib might ring a bell.

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

To be honest, I don't have a strong opinion here. Your choice :-)

Alright.
@koppor Then I suggest the going with the current:
"Cite with ease: Insert citations directly into your LibreOffice document."
Looks cleaner (and more digestible for a general audience, even for students like me who didn't use LaTeX during the college course, the story of which I mentioned in the blog's introductory paragraph).
Also changed "flexibility"->"ease".

subhramit · 2024-08-26T09:17:53Z

Hey, if everyone's alright with it, let's publish today (formally it's my last submission date)
@koppor @Siedlerchr @ThiloteE

I will then link it at the end of my report.

Siedlerchr

from my point of view lgtm

ThiloteE

I propose to slightly reword a few sentences. Also I propose to add dots at the end of full sentences in (numbered) bullet point lists, based on https://www.microsoft.com/en-us/microsoft-365-life-hacks/writing/punctuating-bullet-point-lists

ThiloteE · 2024-08-26T11:18:37Z

_posts/2024-08-23-GSoC-CSL.md

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


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.

ThiloteE · 2024-08-26T11:20:34Z

_posts/2024-08-23-GSoC-CSL.md

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


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.

ThiloteE · 2024-08-26T11:40:49Z

_posts/2024-08-23-GSoC-CSL.md

+3. Click on "Select style" from the panel
+4. Choose your preferred CSL style from the list and click OK
+5. Select an entry (or a group of entries) and click "Cite" to insert citations into the document
+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


Press the "Make/Sync bibliography" button to auto-generate a bibliography section in your document based on your citations and the selected CSL style.

ThiloteE · 2024-08-26T11:41:53Z

_posts/2024-08-23-GSoC-CSL.md

+2. Connect to a running LibreOffice document instance from the [Libre/OpenOffice Panel](https://docs.jabref.org/cite/openofficeintegration)
+3. Click on "Select style" from the panel
+4. Choose your preferred CSL style from the list and click OK
+5. Select an entry (or a group of entries) and click "Cite" to insert citations into the document


Select an entry (or a group of entries) and click the "Cite" button to insert citations into the document.

ThiloteE · 2024-08-26T11:42:21Z

_posts/2024-08-23-GSoC-CSL.md

+1. Download the [development version of JabRef](https://builds.jabref.org/main/)
+2. Connect to a running LibreOffice document instance from the [Libre/OpenOffice Panel](https://docs.jabref.org/cite/openofficeintegration)
+3. Click on "Select style" from the panel
+4. Choose your preferred CSL style from the list and click OK


Choose your preferred CSL style from the list and click "OK".

ThiloteE · 2024-08-26T11:43:39Z

_posts/2024-08-23-GSoC-CSL.md

+
+1. Download the [development version of JabRef](https://builds.jabref.org/main/)
+2. Connect to a running LibreOffice document instance from the [Libre/OpenOffice Panel](https://docs.jabref.org/cite/openofficeintegration)
+3. Click on "Select style" from the panel


Click on "Select style".

ThiloteE · 2024-08-26T11:46:47Z

_posts/2024-08-23-GSoC-CSL.md

+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 from the [Libre/OpenOffice Panel](https://docs.jabref.org/cite/openofficeintegration)


Connect to a running LibreOffice document instance by either clicking the "Connect" or "Manual Connect" button in the Libre/OpenOffice Panel in the side pane.

ThiloteE · 2024-08-26T11:47:13Z

_posts/2024-08-23-GSoC-CSL.md

+
+To start using this new feature:
+
+1. Download the [development version of JabRef](https://builds.jabref.org/main/)


Download the development version of JabRef.

subhramit · 2024-08-26T12:34:22Z

@ThiloteE I have acted on your review. I have used "Click" instead of "Press" to keep consistency.

subhramit added 7 commits August 23, 2024 03:10

Add author

ef8950c

Add blog & asset

e65c5f8

Fix typo

114e724

Add "Background" heading

8721224

better concludign sentence

fbfc08d

!->.

bc47f50

add gifs, replace video

ba88b48

koppor requested changes Aug 24, 2024

View reviewed changes

_posts/2024-08-23-GSoC-CSL.md Outdated Show resolved Hide resolved

_posts/2024-08-23-GSoC-CSL.md Outdated Show resolved Hide resolved

_posts/2024-08-23-GSoC-CSL.md Outdated Show resolved Hide resolved

subhramit and others added 5 commits August 24, 2024 18:16

Update _posts/2024-08-23-GSoC-CSL.md

1d515f9

Co-authored-by: Oliver Kopp <[email protected]>

Update _posts/2024-08-23-GSoC-CSL.md

e102331

Co-authored-by: Oliver Kopp <[email protected]>

remove full stop

77afc34

Update _posts/2024-08-23-GSoC-CSL.md

d30ba4b

Co-authored-by: Oliver Kopp <[email protected]>

Move paragraph

558b08d

subhramit requested a review from koppor August 24, 2024 13:28

koppor reviewed Aug 24, 2024

View reviewed changes

Update 2024-08-23-GSoC-CSL.md

e93155d

Change to passive voice

subhramit requested a review from koppor August 24, 2024 16:58

koppor requested changes Aug 25, 2024

View reviewed changes

Review

28d41dd

subhramit requested a review from koppor August 25, 2024 11:04

Sentence reconstruction

b0f09af

subhramit requested a review from ThiloteE August 25, 2024 21:33

Siedlerchr approved these changes Aug 26, 2024

View reviewed changes

ThiloteE requested changes Aug 26, 2024

View reviewed changes

Thilo's review

e1907b3

subhramit requested a review from ThiloteE August 26, 2024 12:34

Remove redundant "specification"

75f40a3

ThiloteE approved these changes Aug 26, 2024

View reviewed changes

subhramit and others added 2 commits August 26, 2024 23:28

Numbers -> bullets

04db679

Update and rename 2024-08-23-GSoC-CSL.md to 2024-08-26-GSoC-CSL.md

52fa49c

koppor approved these changes Aug 26, 2024

View reviewed changes

koppor merged commit 949cb04 into JabRef:main Aug 26, 2024
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Blog post: CSL4LibreOffice #97

Blog post: CSL4LibreOffice #97

subhramit commented Aug 23, 2024

koppor Aug 24, 2024

koppor left a comment

koppor Aug 25, 2024

koppor Aug 25, 2024

koppor Aug 25, 2024

subhramit Aug 25, 2024 •

edited

Loading

subhramit Aug 25, 2024

koppor Aug 25, 2024 •

edited

Loading

subhramit Aug 25, 2024

subhramit Aug 25, 2024

ThiloteE Aug 25, 2024

subhramit Aug 25, 2024 •

edited

Loading

ThiloteE Aug 25, 2024

subhramit Aug 25, 2024 •

edited

Loading

subhramit commented Aug 26, 2024 •

edited

Loading

Siedlerchr left a comment

ThiloteE left a comment

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

ThiloteE Aug 26, 2024

subhramit commented Aug 26, 2024


		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, [we welcome your feedback and suggestions for further improvements](https://discourse.jabref.org/c/feedback/3).


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

		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!


		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.


		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.


		To start using this new feature:

		1. Download the [development version of JabRef](https://builds.jabref.org/main/)

Blog post: CSL4LibreOffice #97

Blog post: CSL4LibreOffice #97

Conversation

subhramit commented Aug 23, 2024

Choose a reason for hiding this comment

koppor left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

subhramit Aug 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

koppor Aug 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

subhramit Aug 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

subhramit Aug 25, 2024 • edited Loading

Choose a reason for hiding this comment

subhramit commented Aug 26, 2024 • edited Loading

Siedlerchr left a comment

Choose a reason for hiding this comment

ThiloteE left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

subhramit commented Aug 26, 2024

subhramit Aug 25, 2024 •

edited

Loading

koppor Aug 25, 2024 •

edited

Loading

subhramit Aug 25, 2024 •

edited

Loading

subhramit Aug 25, 2024 •

edited

Loading

subhramit commented Aug 26, 2024 •

edited

Loading