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

Show a welcome screen if no database is open #12272

Closed
tobiasdiez opened this issue Dec 5, 2015 · 45 comments · Fixed by #12461
Closed

Show a welcome screen if no database is open #12272

tobiasdiez opened this issue Dec 5, 2015 · 45 comments · Fixed by #12461
Assignees
Labels
📍 Assigned Assigned by assign-issue-action (or manually assigned) good first issue An issue intended for project-newcomers. Varies in difficulty. 📌 Pinned

Comments

@tobiasdiez
Copy link
Member

JabRef looks really naked If no database is opened. Instead one could display a nice picture (of what?) and a message inviting the user to open/create a database.

@koppor
Copy link
Member

koppor commented Dec 5, 2015

Maybe we can bring back the image of our splash screen somehow (#89)? The splash screen was liked by some users: #360

Possibly, an example library should be displayed with some example entries and example groups to show the power of JabRef?

@simonharrer
Copy link
Contributor

Atom cycles through tips/tricks when no file is opened. This is really nice.

I think we do not need the splash screen again.

@oscargus
Copy link
Contributor

oscargus commented Dec 6, 2015

Tips and tricks would be very nice! There are so many features of JabRef that people are not aware of (which recent emails clearly have shown).

@matthiasgeiger
Copy link
Member

Or something like this:
intellij

@simonharrer
Copy link
Contributor

👍

@koppor koppor mentioned this issue Aug 19, 2021
3 tasks
@koppor koppor added the good first issue An issue intended for project-newcomers. Varies in difficulty. label Sep 22, 2021
@calixtus
Copy link
Member

@koppor
Copy link
Member

koppor commented Nov 10, 2022

It should be possible to create an example data base:

For new users, an example lib would be good. It should be named example.bib and showing some features. Maybe a howto. Showing groups etc.

(old issue: https://github.com/koppor/jabref/issues/374)

@calixtus
Copy link
Member

complex.bib from testresources?

@koppor
Copy link
Member

koppor commented Jan 2, 2023

Offered default preferences:

  • I am a "I don't care user" and want all cool features activated
  • I am a pro-user wanting to manage BibTeX files only and thus do not want JabRef to do fancy stuff (reefs Deactivate fulltextsearch as default #9491)

@koppor
Copy link
Member

koppor commented Jan 2, 2023

Welcome screen if no library is open

(might happen if all libraries are closed and JabRef restarted)

It is not the same, something leightweight (see below)

Is this same-same as walkthrough? No, we remove preferences setting ("full text search", "include telemetry", ... ) after first close.

Welcome walkthrough

Welcome "screen" on first start (after installation) showing features, offering sensible defaults, ...

@tobiasdiez
Copy link
Member Author

Please don't put too much information on the welcome screen. It should help people getting started (first users) or provide shortcuts to the most commonly used features (existing users).

As a datapoint (verified by user research as described in microsoft/vscode#63152), VS code moved from the busy old version

to the more minimal new page
image

I would argue that for us the simple "Open / create library" plus a list of recent libraries is sufficient as well. Maybe add a link to our docs, since our user interface is definitely not as self explanatory as the one of vscode.

For new users, VScode has a nice walkthrough but I don't see us implementing something like this soon (given our manpower, but maybe this would be a nice gsoc project?):

@koppor
Copy link
Member

koppor commented Jan 3, 2023

With "Welcome screen on first start (after installation)", I meant the "walkthrough" by VS.Code. I had a single page in mind, but a walkthrough is better, because of the different areas we cover. A quick implementation could have it on one page though.

For the walkthrough, we IMHO need experienced JabRef users, to really cover all features.

I move this discussion to another place to focus here on the "welcome screen"

@koppor
Copy link
Member

koppor commented Jan 3, 2023

Also think of the empty database case

However, this is handled at JabRef#384.

grafik

@u7229988-Rabie
Copy link

Hi, I am a first-time contributor, can I be assigned to this issue? I am a university student whose assignment requires me to contribute to open-source projects.

@koppor
Copy link
Member

koppor commented Oct 18, 2023

@u7229988-Rabie Yes, go ahead. Do that what tobias suggested at https://github.com/koppor/jabref/issues/96#issuecomment-1369502257

I would argue that for us the simple "Open / create library" plus a list of recent libraries is sufficient as well. Maybe add a link to our docs, since our user interface is definitely not as self explanatory as the one of vscode.

@u7229988-Rabie
Copy link

@u7229988-Rabie Yes, go ahead. Do that what tobias suggested at #96 (comment)

I would argue that for us the simple "Open / create library" plus a list of recent libraries is sufficient as well. Maybe add a link to our docs, since our user interface is definitely not as self-explanatory as the one of vscode.

Thank you for assigning me this issue.

@u7229988-Rabie
Copy link

Hello, can anyone suggest the design of the welcome page? For Instance, what kind of information do the maintainers want me to add on the welcome screen (anything particular)? I.e, buttons linking to other pages, information regarding Jabref etc.

Thank you.

@tobiasdiez
Copy link
Member Author

Something like this:
210321312-7cb0b0ed-b3d0-49bd-8d1f-3039aeac1fbd

@u7229988-Rabie
Copy link

u7229988-Rabie commented Oct 19, 2023

I am running the latest version of Gradle (8.4). However, I am still getting "Gradle Deprecated problems". The error suggests that I should be using Gradle 9.0. Can anyone please suggest how I can solve this error? I think Gradle 8.4 is the latest Gradle version.

Thank you

image

@calixtus
Copy link
Member

Please use the latest version of java to run jabref as described in the documentation (https://devdocs.jabref.org/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/intellij-12-build.html)

@calixtus
Copy link
Member

Note that the most recent version of java is 21.0.1

@Siedlerchr
Copy link
Member

@calixtus jdk 21 is not yet working with gradle . You need 20

oops-shlok added a commit to oops-shlok/jabref that referenced this issue Feb 18, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Feb 23, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Feb 25, 2025
@ThiloteE ThiloteE moved this from Assigned to In Progress in Good First Issues Feb 26, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 4, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 4, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 4, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 4, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 6, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 8, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 8, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 8, 2025
@koppor koppor mentioned this issue Mar 9, 2025
7 tasks
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 11, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 11, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 11, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 17, 2025
oops-shlok added a commit to oops-shlok/jabref that referenced this issue Mar 19, 2025
koppor added a commit to oops-shlok/jabref that referenced this issue Mar 19, 2025
github-merge-queue bot pushed a commit that referenced this issue Mar 19, 2025
* Fix #12272 - Show a welcome screen if no database is open

* Fix #12272 - Fix missing localisation keys for WelcomePage

* Fix #12272 - Fix missing localisation keys for WelcomePage

* Fix #12272 - Addressed 1st Review Changes

* Fix #12272 - Checkstyle issue fix in ExportCommand file

* Reverted csl-styles submodule changes

* Reverted abbrv.jabref.org submodule changes

* Integrated WelcomePage in WelcomeTab and code changes

* Implemented  Review Changes 5

* Fix #12272 - Localization key fix in JabRef_en.properties

* Implemented Open Welcome tab in help menu option and open welcome tab if no library is open

* Implemented Review Changes 6

* Reverted Interface changes and fixed save as and save for welcome tab

* Fixed checkstyle import issue

* Simplify and fix casting

* Fix casting

* Fixed Responsiveness

* Undo newlines in MainToolBar.java

* Added Footer for Welcome Tab

* Fixed Localization issues

* Fixed Recents Library issue

* Fixed Tragbot review for Footer

* Refactored the code as suggested in review comments

* Introduced URLs Util

* Fixed Localization issues

* Fixed Localization issues

* Fixed Localization issues

* Fixed missing Localization in WelcomeTab

* Fixed missing Localization in WelcomeTab

* Fixed Review changes

* Added Changelog entry

* Update src/main/java/org/jabref/gui/frame/JabRefFrame.java

* Update src/main/java/org/jabref/gui/WelcomeTab.java

* Update src/main/java/org/jabref/gui/frame/JabRefFrame.java

* Fixed Localization issue

* Fix position of showing welcome tab

* Streamline wording

* Remove obsolete strings

* Fix obsolete code

* Fix comment

* Fix localization

---------

Co-authored-by: Carl Christian Snethlage <[email protected]>
Co-authored-by: Oliver Kopp <[email protected]>
@github-project-automation github-project-automation bot moved this from In Progress to Done in Good First Issues Mar 19, 2025
@github-project-automation github-project-automation bot moved this from Normal priority to Done in Prioritization Mar 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📍 Assigned Assigned by assign-issue-action (or manually assigned) good first issue An issue intended for project-newcomers. Varies in difficulty. 📌 Pinned
Projects
Status: Done
Status: Done
Development

Successfully merging a pull request may close this issue.