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

Add disable/enable calculation of items in group (2) #6244

Closed
wants to merge 84 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
84 commits
Select commit Hold shift + click to select a range
72c022e
Adjusted GroupNodeViewModel.java.
Gena928 Apr 5, 2020
1f4e4ad
Adjusted GroupNodeViewModel.
Gena928 Apr 6, 2020
ebd6284
Update GroupNodeViewModel.java
Gena928 Apr 6, 2020
c0990dc
Injected PreferencesService using a constructor call.
Gena928 Apr 11, 2020
1b5d16d
Merge branch 'master' into 6042(2)
tobiasdiez Apr 28, 2020
f6c12f4
Update GroupNodeViewModel.java
tobiasdiez Apr 28, 2020
3f368e9
Fixed an issue where a new entry is not shown in the library if a fil…
nsmt09 May 1, 2020
c8da256
Partial fix for issue 5891
May 8, 2020
ce33357
Added more tests
May 8, 2020
3df1342
Added more tests
May 9, 2020
5454a09
Added more tests
May 9, 2020
e066958
Merge branch 'fix-for-issue-5891' of https://github.com/silverhorse/j…
May 12, 2020
40541ad
Small update to resolve GIT conflict
Gena928 May 22, 2020
9287490
Return true in action helper if file is online link
Siedlerchr May 22, 2020
d4f23fa
fix checkstyle
Siedlerchr May 22, 2020
b1e899a
Adjusted fix by using StateManager for clearing search bar
nsmt09 May 22, 2020
a9eeb05
Merge branch 'master' into fix-for-issue-6297
Siedlerchr May 22, 2020
7748940
Update ActionHelper.java
tobiasdiez May 22, 2020
c8344be
Merge branch 'master' into 6042(2)
tobiasdiez May 22, 2020
dffcf78
Merge pull request #6511 from JabRef/fixActionHelperWithOnlineLink
Siedlerchr May 22, 2020
2c1a69e
Refactored tableColumnsTab and tableTab, changed to PreferencesService
calixtus May 22, 2020
9882c6d
Fix help file tests
tobiasdiez May 23, 2020
e277c0c
Remove Grobid also from tests
tobiasdiez May 23, 2020
e76a92c
Extend the bib file for better screenshots
tobiasdiez May 23, 2020
03e3663
Refactor externalprefs (#6509)
calixtus May 23, 2020
3e96170
Merge pull request #6513 from JabRef/fetcherHelp
Siedlerchr May 24, 2020
737af75
Add javadoc and fix the preview update issue
leitianjian May 24, 2020
2a5717c
Merged entry table tabs
calixtus May 24, 2020
ab50ca8
Refactored MainTableNameFormatter
calixtus May 24, 2020
cb6804e
CHANGELOG.md
calixtus May 24, 2020
fa5f879
Merge pull request #6514 from JabRef/extendBib
Siedlerchr May 24, 2020
c8949bd
Added cache and comments
calixtus May 24, 2020
ead191e
Merge remote-tracking branch 'upstream/master' into refactor_tableprefs
calixtus May 24, 2020
8d468cb
Bump flexmark-ext-gfm-tasklist from 0.61.30 to 0.61.32
dependabot-preview[bot] May 25, 2020
4f75f57
Bump flexmark from 0.61.30 to 0.61.32
dependabot-preview[bot] May 25, 2020
196f937
Bump archunit-junit5-api from 0.13.1 to 0.14.1
dependabot-preview[bot] May 25, 2020
20c70a9
Merge pull request #6520 from JabRef/dependabot/gradle/com.vladsch.fl…
Siedlerchr May 25, 2020
7d3bd7b
Merge pull request #6521 from JabRef/dependabot/gradle/com.vladsch.fl…
Siedlerchr May 25, 2020
59361fc
Bump flexmark-ext-gfm-strikethrough from 0.61.30 to 0.61.32
dependabot-preview[bot] May 25, 2020
43262c3
Merge pull request #6522 from JabRef/dependabot/gradle/com.vladsch.fl…
Siedlerchr May 25, 2020
bc1e341
Merge pull request #6523 from JabRef/dependabot/gradle/com.tngtech.ar…
Siedlerchr May 25, 2020
d01f370
Fixed main table refresh
calixtus May 25, 2020
b86800c
Revert to old switch expression for checkstyle compatibility
calixtus May 25, 2020
0bd2fd2
Revert more switch expressions for checkstyle compatibility
calixtus May 25, 2020
25bd506
CHANGELOG.md
calixtus May 25, 2020
6f34de3
Merge pull request #6407 from nsmt09/fix-for-issue-6297
Siedlerchr May 25, 2020
86b04a7
Merge pull request #6516 from leitianjian/entry-preview-content-update
Siedlerchr May 25, 2020
0d7156b
Fixes missing library properties context menu on library tab (#6508)
Oltman-B May 26, 2020
861e61e
Allow entrytype as sorting criterion
Siedlerchr May 27, 2020
56b0cee
update changelog
Siedlerchr May 27, 2020
104f697
checkstyle argh
Siedlerchr May 27, 2020
bb19d29
Merge pull request #6531 from JabRef/fixEntryTypeMissing
Siedlerchr May 27, 2020
47846bf
Enable users to simultaneously search all SearchBasedFetchers (#6504)
DominikVoigt May 27, 2020
c119ca2
Add markdown checks (and fix some markdown issues) (#6524)
koppor May 27, 2020
4b997f8
updating text for checkbox
May 28, 2020
5668049
reverting change from other properties files
May 28, 2020
62a6961
Merge branch 'master' of https://github.com/JabRef/jabref into fix-fo…
May 28, 2020
08eccb6
Fixes generated bibtex key and display of institute authors (#6479)
k3KAW8Pnf7mkmdSMPHz27 May 28, 2020
62f3038
Merge remote-tracking branch 'upstream/master' into refactor_tableprefs
calixtus May 28, 2020
3135197
Extracted JabRefPrefences out of PersistenceVisualStateTable
calixtus May 28, 2020
526ba89
Fix links in the readme
tobiasdiez May 28, 2020
0ce7c8f
updating text
May 28, 2020
6a1940f
updating text
May 28, 2020
ffa07cd
Merge pull request #6451 from silverhorse/fix-for-issue-5891
Siedlerchr May 28, 2020
d43bcfa
Switch to upstream version of markdow-lint (#6544)
koppor May 28, 2020
c1867e5
Fixed merge error
calixtus May 28, 2020
41678ce
Merge pull request #6518 from JabRef/refactor_tableprefs
Siedlerchr May 28, 2020
ad8ac9d
Bump flexmark from 0.61.32 to 0.62.0
dependabot-preview[bot] May 28, 2020
4eb2316
Bump flexmark-ext-gfm-tasklist from 0.61.32 to 0.62.0
dependabot-preview[bot] May 28, 2020
cab28ab
Bump bcprov-jdk15on from 1.65 to 1.65.01
dependabot-preview[bot] May 28, 2020
8ff20f1
Merge pull request #6550 from JabRef/dependabot/gradle/org.bouncycast…
Siedlerchr May 29, 2020
a852963
Merge pull request #6547 from JabRef/dependabot/gradle/com.vladsch.fl…
Siedlerchr May 29, 2020
5cb139c
Merge pull request #6548 from JabRef/dependabot/gradle/com.vladsch.fl…
Siedlerchr May 29, 2020
8b35b69
Restructure first paragraph
koppor May 29, 2020
2c30f20
Fix html
koppor May 29, 2020
9742ee1
Bump flexmark-ext-gfm-strikethrough from 0.61.32 to 0.62.0 (#6546)
dependabot-preview[bot] May 29, 2020
53e8c36
Add authors
koppor May 29, 2020
68f90c0
Merge branch '6042(2)' of git://github.com/Gena928/jabref into Gena92…
calixtus May 29, 2020
684abf6
Adjusted GroupNodeViewModel.java.
Gena928 Apr 5, 2020
58e5492
Adjusted GroupNodeViewModel.
Gena928 Apr 6, 2020
2155917
Update GroupNodeViewModel.java
Gena928 Apr 6, 2020
30cb675
Injected PreferencesService using a constructor call.
Gena928 Apr 11, 2020
5c1998f
Update GroupNodeViewModel.java
tobiasdiez Apr 28, 2020
2da0d06
Merge branch '6042(2)' of https://github.com/Gena928/jabref into 6042(2)
calixtus May 29, 2020
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
5 changes: 5 additions & 0 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,11 @@ jobs:
key: ${{ runner.os }}-gradle-${{ hashFiles('gradle/wrapper/gradle-wrapper.properties') }}
- name: Run checkstyle
run: ./gradlew checkstyleMain checkstyleTest checkstyleJmh
- name: Run markdown-lint
uses: avto-dev/markdown-lint@v1
with:
args: CHANGELOG.md README.md docs/
config: '.markdownlint.yml'
tests:
name: Unit tests
runs-on: ubuntu-latest
Expand Down
2 changes: 2 additions & 0 deletions .mailmap
Original file line number Diff line number Diff line change
Expand Up @@ -200,3 +200,5 @@ Gennadiy Stakhovskiy <GennadiyStakhovskiy@gmail.com>
Mootez Saad <34676841+MootezSaaD@users.noreply.github.com>
Mootez Saad <34676841+MootezSaaD@users.noreply.github.com> <mootez.saad@medtech.tn>
Chen Yuheng <pass@chenyuheng.cn>
Dominik Voigt <43381984+DominikVoigt@users.noreply.github.com>
Carl Christian Snethlage <50491877+calixtus@users.noreply.github.com> <cc.snethlage@gmail.com>
18 changes: 18 additions & 0 deletions .markdownlint.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
default: true

# Using h2 has side effects in GitBook's toc. Thus, we sometimes switch from h1 to h3
MD001: false

MD012:
# 2 are required, because GitBook adss two blank lines at the end of a file
maximum: 2

MD013: false

# The FAQs state questions - we allow them
MD026:
punctuation: ".,;:!"

MD033:
# we have <a> tags with ids
allowed_elements: ['a']
4 changes: 4 additions & 0 deletions AUTHORS
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ Andreas Buhr
Andreas Rudert
Andrew Collins
Andrew Levit
André Schlichting
Andrés Sánchez
Anh Nghia Tran
Anita Armbruster
Expand All @@ -40,6 +41,7 @@ August Janse
Ayachi Nene
Bartosz J. Kaczkowski
Bartłomiej Dach
Baruch Oltman
Behrouz Javanmardi
Benedikt Tutzer
Benjamin Köhler
Expand Down Expand Up @@ -96,6 +98,7 @@ Dimitra Karadima
Domenico Cufalo
Dominik Schrempf
Dominik Traczyk
Dominik Voigt
Dominik Waßenhoven
Douglas Nassif Roma Junior
Eduard Braun
Expand Down Expand Up @@ -260,6 +263,7 @@ Nick S. Weatherley
Nico Schlömer
Nicolas Pavillon
Nikita Borovikov
Niklas Schmitt
nikmilpv
NikodemKch
Niv Ierushalmi
Expand Down
14 changes: 12 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve

### Added

- We added the Library properties to a context menu on the library tabs [#6485](https://github.com/JabRef/jabref/issues/6485)
- We added a new field in the preferences in 'BibTeX key generator' for unwanted characters that can be user-specified. [#6295](https://github.com/JabRef/jabref/issues/6295)
- We added support for searching ShortScience for an entry through the user's browser. [#6018](https://github.com/JabRef/jabref/pull/6018)
- We updated EditionChecker to permit edition to start with a number. [#6144](https://github.com/JabRef/jabref/issues/6144)
Expand All @@ -24,6 +25,8 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We fixed the bug when strike the delete key in the text field. [#6421](https://github.com/JabRef/jabref/issues/6421)
- We added a BibTex key modifier for truncating strings. [#3915](https://github.com/JabRef/jabref/issues/3915)
- We added support for jumping to target entry when typing letter/digit after sorting a column in maintable [#6146](https://github.com/JabRef/jabref/issues/6146)
- We added a new fetcher to enable users to search all available E-Libraries simultaneously. [koppor#369](https://github.com/koppor/jabref/issues/369)
- We added the field "entrytype" to the export sort criteria [#6531](https://github.com/JabRef/jabref/pull/6531)

### Changed

Expand All @@ -37,9 +40,11 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We improved the error message for invalid jstyles. [#6303](https://github.com/JabRef/jabref/issues/6303)
- We changed the section name of 'Advanced' to 'Network' in the preferences and removed some obsolete options.[#6489](https://github.com/JabRef/jabref/pull/6489)
- We improved the context menu of the column "Linked identifiers" of the main table, by truncating their texts, if they are too long. [#6499](https://github.com/JabRef/jabref/issues/6499)
- We merged the main table tabs in the preferences dialog. [#6518](https://github.com/JabRef/jabref/pull/6518)

### Fixed

- We fixed to only search file links in the BIB file location directory when preferences has corresponding checkbox checked. [#5891](https://github.com/JabRef/jabref/issues/5891)
- We fixed wrong button order (Apply and Cancel) in ManageProtectedTermsDialog.
- We fixed an issue with incompatible characters at BibTeX key [#6257](https://github.com/JabRef/jabref/issues/6257)
- We fixed an issue where dash (`-`) was reported as illegal BibTeX key [#6295](https://github.com/JabRef/jabref/issues/6295)
Expand All @@ -63,6 +68,7 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We fixed an issue where JabRef switched to discrete graphics under macOS [#5935](https://github.com/JabRef/jabref/issues/5935)
- We fixed an issue where the Preferences entry preview will be unexpected modified leads to Value too long exception [#6198](https://github.com/JabRef/jabref/issues/6198)
- We fixed an issue where custom jstyles for Open/LibreOffice would only be valid if a layout line for the entry type `default` was at the end of the layout section [#6303](https://github.com/JabRef/jabref/issues/6303)
- We fixed an issue where a new entry is not shown in the library if a search is active [#6297](https://github.com/JabRef/jabref/issues/6297)
- We fixed an issue where long directory names created from patterns could create an exception. [#3915](https://github.com/JabRef/jabref/issues/3915)
- We fixed an issue where sort on numeric cases was broken. [#6349](https://github.com/JabRef/jabref/issues/6349)
- We fixed an issue where year and month fields were not cleared when converting to biblatex [#6224](https://github.com/JabRef/jabref/issues/6224)
Expand All @@ -71,6 +77,9 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We fixed an issue where brackets in regular expressions were not working. [6469](https://github.com/JabRef/jabref/pull/6469)
- We fixed an issue where LaTeX citations for specific commands (\autocites) of biblatex-mla were not recognized. [#6476](https://github.com/JabRef/jabref/issues/6476)
- We fixed an issue where drag and drop was not working on empty database. [#6487](https://github.com/JabRef/jabref/issues/6487)
- We fixed an issue where the name fields were not updated after the preferences changed. [#6515](https://github.com/JabRef/jabref/issues/6515)
- We fixed an issue where "null" appeared in generated BibTeX keys. [#6459](https://github.com/JabRef/jabref/issues/6459)
- We fixed an issue where the authors' names were incorrectly displayed in the authors' column when they were bracketed. [#6465](https://github.com/JabRef/jabref/issues/6465) [#6459](https://github.com/JabRef/jabref/issues/6459)

### Removed

Expand Down Expand Up @@ -127,6 +136,7 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We fixed an issue where the blue and red text colors in the Merge entries dialog were not quite visible [#6334](https://github.com/JabRef/jabref/issues/6334)
- We fixed an issue where underscore character was removed from the file name in the Recent Libraries list in File menu [#6383](https://github.com/JabRef/jabref/issues/6383)
- We fixed an issue where few keyboard shortcuts regarding new entries were missing [#6403](https://github.com/JabRef/jabref/issues/6403)

### Removed

- Ampersands are no longer escaped by default in the `bib` file. If you want to keep the current behaviour, you can use the new "Escape Ampersands" formatter as a save action. [#5869](https://github.com/JabRef/jabref/issues/5869)
Expand Down Expand Up @@ -302,8 +312,8 @@ Note that this project **does not** adhere to [Semantic Versioning](http://semve
- We fixed an issue where some journal names were wrongly marked as abbreviated. [#4115](https://github.com/JabRef/jabref/issues/4115)
- We fixed an issue where the custom file column were sorted incorrectly. [#3119](https://github.com/JabRef/jabref/issues/3119)
- We improved the parsing of author names whose infix is abbreviated without a dot. [#4864](https://github.com/JabRef/jabref/issues/4864)
- We fixed an issues where the entry losses focus when a field is edited and at the same time used for sorting. https://github.com/JabRef/jabref/issues/3373
- We fixed an issue where the menu on Mac OS was not displayed in the usual Mac-specific way. https://github.com/JabRef/jabref/issues/3146
- We fixed an issues where the entry losses focus when a field is edited and at the same time used for sorting. [#3373](https://github.com/JabRef/jabref/issues/3373)
- We fixed an issue where the menu on Mac OS was not displayed in the usual Mac-specific way. [#3146](https://github.com/JabRef/jabref/issues/3146)
- We improved the integrity check for page numbers. [#4113](https://github.com/JabRef/jabref/issues/4113) and [feature request in the forum](http://discourse.jabref.org/t/pages-field-allow-use-of-en-dash/1199)
- We fixed an issue where the order of fields in customized entry types was not saved correctly. [#4033](http://github.com/JabRef/jabref/issues/4033)
- We fixed an issue where renaming a group did not change the group name in the interface. [#3189](https://github.com/JabRef/jabref/issues/3189)
Expand Down
18 changes: 6 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
JabRef is an open-source, cross-platform citation and reference management tool.

Stay on top of your literature: JabRef helps you to collect and organize sources, find the paper you need and discover the latest research.
![main table](https://www.jabref.org/img/jabref-5-0-maintable.png)
![main table](http://www.jabref.org/img/jabref-mainscreen.png)

## Features

JabRef is a cross-platform application that works on Windows, Linux and Mac OS X. It is available free of charge and is actively developed.
JabRef supports you in every step of your research work.
JabRef is available free of charge and is actively developed.
It supports you in every step of your research work.

### Collect

Expand All @@ -33,7 +33,7 @@ JabRef supports you in every step of your research work.

### Cite

- Native [BibTeX] and [Biblatex] support
- Native BibTeX and Biblatex support
- Cite-as-you-write functionality for external applications such as Emacs, Kile, LyX, Texmaker, TeXstudio, Vim and WinEdt.
- Format references in one of the many thousand built-in citation styles or create your style
- Support for Word and LibreOffice/OpenOffice for inserting and formatting citations
Expand All @@ -47,11 +47,9 @@ JabRef supports you in every step of your research work.
## Installation

Fresh development builds are available at [builds.jabref.org](https://builds.jabref.org/master/).
The [latest stable release is available at FossHub](https://www.fosshub.com/JabRef.html).
The [latest stable release is available at FossHub](https://downloads.jabref.org/).

- Windows: JabRef offers an installer, which also adds a shortcut to JabRef to your start menu. Please also see our [Windows FAQ](https://docs.jabref.org/faq/faqwindows)
- Linux: Please see our [Installation Guide](https://docs.jabref.org/general/installation).
- Mac OS X: Please see our [Mac OS X FAQ](https://docs.jabref.org/faq/faqosx).
Please see our [Installation Guide](https://docs.jabref.org/installation).

## Bug Reports, Suggestions, Other Feedback

Expand Down Expand Up @@ -98,8 +96,4 @@ For IntelliJ IDEA, just import the project via a Gradle Import by pointing at th

`gradlew test` executes all tests. We use [Github Actions](https://github.com/JabRef/jabref/actions) for executing the tests after each commit. For developing, it is sufficient to locally only run the associated test for the classes you changed. Github will report any other failure.

[BibTeX]: https://www.ctan.org/pkg/bibtex
[Biblatex]: https://www.ctan.org/pkg/biblatex
[install4j]: https://www.ej-technologies.com/products/install4j/overview.html
[JabRef]: https://www.jabref.org
[JavaFX]: https://en.wikipedia.org/wiki/JavaFX
10 changes: 5 additions & 5 deletions build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ dependencies {
implementation group: 'org.apache.tika', name: 'tika-core', version: '1.24.1'

// required for reading write-protected PDFs - see https://github.com/JabRef/jabref/pull/942#issuecomment-209252635
implementation 'org.bouncycastle:bcprov-jdk15on:1.65'
implementation 'org.bouncycastle:bcprov-jdk15on:1.65.01'

implementation 'commons-cli:commons-cli:1.4'

Expand Down Expand Up @@ -192,9 +192,9 @@ dependencies {
exclude module: "log4j-core"
}

implementation 'com.vladsch.flexmark:flexmark:0.61.30'
implementation 'com.vladsch.flexmark:flexmark-ext-gfm-strikethrough:0.61.30'
implementation 'com.vladsch.flexmark:flexmark-ext-gfm-tasklist:0.61.30'
implementation 'com.vladsch.flexmark:flexmark:0.62.0'
implementation 'com.vladsch.flexmark:flexmark-ext-gfm-strikethrough:0.62.0'
implementation 'com.vladsch.flexmark:flexmark-ext-gfm-tasklist:0.62.0'

testImplementation 'io.github.classgraph:classgraph:4.8.78'
testImplementation 'org.junit.jupiter:junit-jupiter:5.6.2'
Expand All @@ -207,7 +207,7 @@ dependencies {
testImplementation 'org.mockito:mockito-core:3.3.3'
testImplementation 'org.xmlunit:xmlunit-core:2.7.0'
testImplementation 'org.xmlunit:xmlunit-matchers:2.7.0'
testImplementation 'com.tngtech.archunit:archunit-junit5-api:0.13.1'
testImplementation 'com.tngtech.archunit:archunit-junit5-api:0.14.1'
testImplementation "org.testfx:testfx-core:4.0.17-alpha-SNAPSHOT"
testImplementation "org.testfx:testfx-junit5:4.0.17-alpha-SNAPSHOT"
testImplementation "org.hamcrest:hamcrest-library:2.2"
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ This log lists the decisions for JabRef.
* [ADR-0007](adr/0007-human-readable-changelog.md) - Provide a human-readable changelog
* [ADR-0008](adr/0008-use-public-final-instead-of-getters.md) - Use public final instead of getters to offer access to immutable variables
* [ADR-0009](adr/0009-use-plain-junit5-for-testing.md) - Use Plain JUnit5 for advanced test assertions
* [ADR-0010](0010-use-h2-as-internal-database.md) - Use H2 as Internal SQL Database
* [ADR-0010](adr/0010-use-h2-as-internal-database.md) - Use H2 as Internal SQL Database

For new ADRs, please use [template.md](adr/template.md) as basis. More information on MADR is available at [https://adr.github.io/madr/](https://adr.github.io/madr/). General information about architectural decision records is available at [https://adr.github.io/](https://adr.github.io/).

1 change: 1 addition & 0 deletions docs/adr/0004-use-mariadb-connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,3 +30,4 @@ The [MySQL Connector](https://www.mysql.com/de/products/connector/) is distribut
* Good, because it stems from the same development team than MySQL
* Bad, because the "Universal FOSS Exception" makes licensing more complicated.

<!-- markdownlint-disable-file MD024 -->
1 change: 1 addition & 0 deletions docs/adr/0006-only-translated-strings-in-language-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,4 @@ Chosen option: "Only translated strings in language file", because comes out bes

* Related to [ADR-0001](0001-use-crowdin-for-translations.md).

<!-- markdownlint-disable-file MD024 -->
28 changes: 14 additions & 14 deletions docs/adr/template.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# \[short title of solved problem and solution\]

* Status: \[proposed \| rejected \| accepted \| deprecated \| … \| superseded by [ADR-0005](https://github.com/JabRef/jabref/tree/8c07a88a823a84aebe987cdb717f318ed00a872d/docs/adr/0005-example.md)\]
* Deciders: \[list everyone involved in the decision\]
* Date: \[YYYY-MM-DD when the decision was last updated\]
* Status: \[proposed \| rejected \| accepted \| deprecated \| … \| superseded by [ADR-0005](0005-fully-support-utf8-only-for-latex-files.md)\]
* Deciders: \[list everyone involved in the decision\]
* Date: \[YYYY-MM-DD when the decision was last updated\]

Technical Story: \[description \| ticket/issue URL\]
Technical Story: \[description \| ticket/issue URL\]

## Context and Problem Statement

Expand All @@ -14,14 +14,14 @@ Technical Story: \[description \| ticket/issue URL\]

* \[driver 1, e.g., a force, facing concern, …\]
* \[driver 2, e.g., a force, facing concern, …\]
* …
* …

## Considered Options

* \[option 1\]
* \[option 2\]
* \[option 3\]
* …
* …

## Decision Outcome

Expand All @@ -41,33 +41,33 @@ Chosen option: "\[option 1\]", because \[justification. e.g., only option, which

### \[option 1\]

\[example \| description \| pointer to more information \| …\]
\[example \| description \| pointer to more information \| …\]

* Good, because \[argument a\]
* Good, because \[argument b\]
* Bad, because \[argument c\]
* …
* …

### \[option 2\]

\[example \| description \| pointer to more information \| …\]
\[example \| description \| pointer to more information \| …\]

* Good, because \[argument a\]
* Good, because \[argument b\]
* Bad, because \[argument c\]
* …
* …

### \[option 3\]

\[example \| description \| pointer to more information \| …\]
\[example \| description \| pointer to more information \| …\]

* Good, because \[argument a\]
* Good, because \[argument b\]
* Bad, because \[argument c\]
* …
* …

## Links

* \[Link type\] \[Link to ADR\]
* …
* \[Link type\] \[Link to ADR\]
* …

7 changes: 4 additions & 3 deletions docs/code-howtos.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ Principles:
Localization.lang("Something went wrong...", ioe);
}
```

* Never, ever throw and catch `Exception` or `Throwable`
* Errors should only be logged when they are finally caught \(i.e., logged only once\). See **Logging** for details.
* If the Exception message is intended to be shown to the User in the UI \(see below\) provide also a localizedMessage \(see `JabRefException`\).
Expand All @@ -45,7 +46,7 @@ To show error message two different ways are usually used in JabRef:
* showing an error dialog
* updating the status bar at the bottom of the main window

_TODO: Usage of status bar and Swing Dialogs_
_*TODO: Usage of status bar and Swing Dialogs*_

## Using the EventSystem

Expand Down Expand Up @@ -138,7 +139,7 @@ JabRef uses the logging facade [SLF4j](https://www.slf4j.org/). All log messages

## Using Localization correctly

_\(More information about this topic from the translator side is provided under this link:_ [_Translating JabRef Interface_](https://github.com/JabRef/jabref/wiki/Translating-JabRef-Interface) _about the JabRef interface and_ [_Translating JabRef Help_](https://github.com/JabRef/jabref/wiki/Translating-JabRef-Help) _about the JabRef help files\)_
More information about this topic from the translator side is provided at [Translating JabRef Interface](https://docs.jabref.org/faqcontributing/how-to-translate-the-ui).

All labeled UI elements, descriptions and messages shown to the user should be localized, i.e., should be displayed in the chosen language.

Expand Down Expand Up @@ -179,7 +180,7 @@ The tests check whether translation strings appear correctly in the resource bun

We try to build a cleanup mechanism based on formatters. The idea is that we can register these actions in arbitrary places, e.g., onSave, onImport, onExport, cleanup, etc. and apply them to different fields. The formatters themself are independent of any logic and therefore easy to test.

Example: [PageNumbersFormatter](https://github.com/JabRef/jabref/blob/master/src/main/java/net/sf/jabref/logic/formatter/bibtexfields/PageNumbersFormatter.java)
Example: [NormalizePagesFormatter](https://github.com/JabRef/jabref/blob/master/src/main/java/org/jabref/logic/formatter/bibtexfields/NormalizePagesFormatter.java)

## Drag and Drop

Expand Down
Loading