jabref / www.jabref.org

Old repository for JabRef's website. Please go to https://github.com/JabRef/JabRefOnline/ for the new repo.

Outdated

This repository for our website has been archived, and all issues are therefore frozen. If you want to contribute, propose a new feature and/or report a bug with the website, please head over to the new repository https://github.com/JabRef/JabRefOnline.

Source of www.jabref.org

This repository contains the source of the JabRef homepage.

Feel free to improve the page using the issue tracker or pull requests.

Local Development

For local development, follow the Jekyll installation instructions. Installing the latest version of ruby followed by gem install bundler should be enough.

Afterwards, run

bundle install
jekyll serve --livereload

and go to http://localhost:4000/ in your browser.

On Windows, using a dockerized environment is recommended:

docker run -p 4000:4000 --rm --volume="C:\git-repositories\jabref\www.jabref.org":/srv/jekyll jekyll/jekyll:4 jekyll serve

In case you get errors regarding Gemfile.lock, just delete Gemfile.lock and rerun.

Incremental building is also possible:

docker run -p 4000:4000 --rm --volume="C:\git-repositories\jabref\www.jabref.org":/srv/jekyll jekyll/jekyll:4 jekyll serve --incremental

Update fonts

Precondition: npm install --global get-google-fonts

get-google-fonts -i http://fonts.googleapis.com/css?family=Lato:300,400,700,300italic,400italic,700italic
npm install --save @fortawesome/fontawesome-free

Notes on the Jekyll version

This homepage is generated using the latest version of Jekyll.

www.jabref.org's Issues

Include logo+description as structured data to improve Google search representation

See https://developers.google.com/search/docs/data-types/logo

Tools for Android outdated

https://github.com/JabRef/www.jabref.org/blob/c8ac603f8252d83c456de9dee1bb628a76f8d8d0/_sections/60-Ressources.md shows a link to Eratosthenes.
Unfortunately, it looks like this project is abandoned, at least it is not available on Google Play.

I tried to find an alternative, but from the four Android apps listed here https://tex.stackexchange.com/questions/230278/edit-and-view-bibtex-database-on-android to read BibTeX files, only one is still on Google Play / F-Droid: https://github.com/cgogolin/library

Regarding the other apps:

• RefMaster seems to be out of business, and seems to be not open source (a discussion can be found here: https://latex.org/forum/viewtopic.php?t=20981)
• Eratosthenes vanished from Google Play, but source is still available: https://bitbucket.org/mkmatlock/eratosthenes/src
• BibRef vanished from Google Play too and does not seem to be open source.

I tested Library and it works with JabRef's .bib files, unfortunately, the display is a bare minimum and the only JabRef feature which is supported are groups, but without the tree view.
But you can open the linked PDFs, search for entries, share the entry and open DOIs.

I dont know if you should still link to Eratosthenes, as there are no binaries but I would certainly like to see Library be mentioned, as it seems to be the only app on Google Play right now which can handle .bib files on Android. If there are other alternatives, please put them there as well :)

Remove FAQ from www.jabref.org/FAQ

The FAQ is now part of the help pages (https://help.jabref.org/en/), so:

• the link in the Help section of the website (https://www.jabref.org/#help) should be updated
• the URL http://www.jabref.org/faq/ should redirect to the help page index (https://help.jabref.org/en/)

Width of FAQ page weird

Firefox latest version, when I click on my mousewheel to fast scroll, I am able to scroll to the left, and the FAQ Contents move left, creating a white area on the right.

Seems like there is some fixed with problem or whatever

Add blog

The site should offer a blogging functionality. The most recent entry should be shown at http://www.jabref.org/#news

URL: http://www.jabref.org/blog

Direct URL to a (sub)section?

I would like to have an URL that could lead directly, for example, to the section "JabRef journal abbreviation lists" of the resources' page (www.jabref.org/#resources).

Is it possible? How?

Bookmark: "Stay on top of your Literature"

With the new design, the title of the page is "Stay on top of your Literature".
The issue is that this is also the title of the bookmark (at least with Firefox). This makes the bookmark difficult to identify afterwards.

Show small logo in header and also a bigger version in the upper part of the page

• Show small logo in header
• Show big logo in upper part of the page

Why?

• Brand recognition
• Images are awesome

Fix failing builds or disable htmlproof

The tool HTMLproofer checks our page for broken links on TravisCI. Currently, this does not work well.

• Some URLs return 0, which indicates some kind of error, but not specified which error (e.g., http://tex.stackexchange.com/tags/jabref/)
• The link to the source of the page is neither working locally nor on TravisCI. Only on GitHub (e.g., /blob/gh-pages/_faq/05_intro.md)

Either we try to fix it or we have to disable htmlproof.

Simplify click path to Download

I'm not really satisfied with current situation regarding downloading JabRef.

If a user lands on jabref.org there are 3 (or even 4) clicks needed to actually start the download:
Scroll down to the Download section (or click on Download), click "Download now" on the github release page, choose the right file at sourceforge.

Why don't we link directly to https://sourceforge.net/projects/jabref/files/latest/download from jabref.org? Using this link automatically the download of latest version matching to the users OS is started.

Besides this download link we still can link to the release notes at github.

FAQ: General: Issues with some Q&A

I have updated/cleaned/clarified the file _faq/10_general.md .
However, 2 Question&Answer need your input.
The issues are indicated by text between square brackets at the beginning of the questions.

FAQ Broken Link

http://www.tex.ac.uk/cgi-bin/texfaq2html is broken.

I think it should now point to http://www.tex.ac.uk/

Fix generated link anchors

Near the bottom of page http://www.fosshub.com/JabRef.html, there is a line

Found this software useful? Please consider a donation to the author. "Button Donate"

This links to http://www.jabref.org/#donations, which leads to the top of the page and not to the donation section.
The link should be http://www.jabref.org/#sections50-donations

Documentation section on www.jabref.org

"Documentation" should part of the header.

JavaScript broken

JS is broken currently.

Ressources: status of OpenOffice style files?

Considering http://discourse.jabref.org/t/referencing-styles-specifically-harvard/260 , I am wondering what is the status of the following OpenOffice style files http://jabref.sourceforge.net/OOPlugin-styles.php , and so if they should be included in the Resources page.

Add anchors to headings

In GitHub's wiki, it is possibly to directly link to headings. For instance https://github.com/JabRef/jabref/wiki#usage-information

This is not possible with default Jekyll. We should enable this for the help site, too. Maybe, this requires building with Jekyll for ourselves and uploading to the gh-pages branch. The latter can easily be done as demonstrated at TSDBCompare.

• Enable generating anchors to headings in Jekyll
• Enable generation of the web site on TravisCI and upload to gh-pages branch

Remove GitHub corner

When browsing the help (https://help.jabref.org/), clicking on the mascot at the upper right-hand corner leads to the edit page of the help. For example, if you are at https://help.jabref.org/en/FAQlinux , you go to https://github.com/JabRef/help.jabref.org/blob/gh-pages/en/FAQlinux.md .

This is not the case for the website (http://www.jabref.org/): it leads to the JabRef source code (https://github.com/JabRef/jabref) instead of the website code (https://github.com/JabRef/www.jabref.org).

Maybe it is a feature, but I was surprised about it.

Create gource.io video for JabRef code

http://gource.io/

There is already a video which captures the dev up to 2015:
https://www.youtube.com/watch?v=WFXNmAKG6vA

Tips on how to create a video:
https://github.com/acaudwell/Gource/wiki/Videos

OSX - Upgrade Path from 2.x to 3.x

The Upgrade from 2.x to 3.x respectively before install4j triggers several conflicts/permission issues during the install progress - this should be added to the OSX FAQ

Localization of the website?

I believed a localized website will attract more people to JabRef than a localized help.
What do you think?

Alexa report about www.jabref.org

From http://www.alexa.com/siteinfo/jabref.org :

• Most visitors from US and Germany (confirming the 2015 survey results)

• 2/3 of visitors coming from sourceforge.net .

• 8% of visitors are coming from a search engine (using a seach for "jabref")

  It will be interesting to see how these 2 figures evolve

Issue ready to be closed. ;-)

Migrate resources.php

In the previous design of the website, there was a page listing additional resources (https://web.archive.org/web/20150208123147/http://jabref.sourceforge.net/resources.php).
I believe we should have a page for this.
If you agree: where should it be located?

Change background color of Resources

Downloads: confusing

Hi,

A colleague of mine have tried to download JabRef from http://www.jabref.org .
She got confused about the available links and decided to click on install4j. Not surprisingly, she found "JabRef" (i.e. Install4j) very confusing for managing a bibliography...
2 points:

• Looking at the page, the item "Releases" looks small compared to the two others.
• Most of users are looking only for the last stable release.

Suggestion: above the item "Releases", add a big button similar to the one of the page https://github.com/JabRef/jabref/releases . Ideally, this button will jump directly to the sourceforge page of the last stable release.

Comment: the sourceforge download pages (e. g. http://sourceforge.net/projects/jabref/files/v3.2/JabRef_windows_3_2.exe/download ) look awful. The advertisements is covering most of the screen, asking for your email address or confusing the user to download crappy software.

Add logo to homepage

Refs JabRef/jabref#1177

Cool gif showcasing the cool features of JabRef

Something similar to https://www.sublimetext.com/ which showcases special features, e.g., the Integrity Check, DOI search and get Document by DOI feature, etc.

bug in "Export"

Jabref 3.2, running on Linux Mint + Cinnamon 17.3.

$java -version
java version "9-ea"
Java(TM) SE Runtime Environment (build 9-ea+102-2016-01-21-001533.javare.4316.nc)
Java HotSpot(TM) 64-Bit Server VM (build 9-ea+102-2016-01-21-001533.javare.4316.nc, mixed mode)

When I try to Export my 3000 entry database from the main File menu, using the "HTML Table (with Abstract and bibtex)" export filter, I get a java NullPointerException error and the export doesn't take place. See this graphic of the error:

Add FAQ for file renaming

One can rename a file using the cleanup functionality.

"One thing to note is that you can change the format(pattern) under Import in the Preferences. Then under the Default PDF file link action you can designate the Filename format pattern." (From https://sourceforge.net/p/jabref/mailman/message/34830638/)

Add alias for github pages

Can we add alias pages to some of the direct github pages. For example,

• issues.jabref.org -> https://github.com/JabRef/jabref/issues
• code.jabref.org -> https://github.com/JabRef/jabref

I think it looks slightly better to refer someone to "post the problem at issues.jabref.org" instead of some github url which for a normal person has nothing to do with issues or jabref. (Slight bonus: maybe get a better pagerank)

Add HTTPS Support for website

Google Ranks websites with HTTPS support higher.
More info on why HTTPS
https://developers.google.com/web/fundamentals/security/encrypt-in-transit/why-https

@koppor Can https be configured?

Update to jekyll 4

https://jekyllrb.com/docs/upgrading/3-to-4/

Create about section (mabye merge with "contribute")

Some users are interested in who we are.

Add workaround for not pushing

Current master workflow does not push. ad-m/github-push-action#2 would be a workaround.

Rename "Intro" to JabRef

Move impressum to small footer link and extra page

Too big at the moment. External page and small link in a footer should be enough.

A blog without syndication? (RSS)

All the issue is in the title...

Add video about PDF management

Add a video explaining following steps:

1. Add entry using the DOI (Web Search -> DOI to BibTeX)
2. Drag'n'drop the PDF into the preview panel of the entry
3. JabRef then asks to rename the PDF according to the bibtex data

Add section CONTRIBUTE

Submit bugs and feature requests - link to issues list
Fix bugs and implement features - Link to "asking-for-pull-request" issues
Improve code quality - link to coverity/codacy/...
Translate jabref - link to localization

No license

I have just notice there is no license for this repository (at least, I could not find it...).

[Blog's post] A faster JabRef

Following JabRef/jabref#1100 , I figure out this is a more suitable place for a discussion.

Please, review (facts and writing) at PR #37.

Tentative publication date : Friday April 8 (a week before the post about the release of version 3.3).

%%%%%%%%%%%%%%%%%%%%%%%%%%

A faster JabRef is coming!

Some users reported JabRef was slow on large databases (thank you for the feedback!). This was especially the case for three operations:

• loading a database
• saving a database
• searching through a database.

During a search, the user interface could become very unresponsive, which is indeed quite annoying... Well, this time will be over soon: @simonharrer has recently contributed code making search much faster (JabRef/jabref#1100). By integrating the Java Microbenchmarking framework (JabRef/jabref#1103), @tobiasdiez was able to benchmark JabRef and reveal interesting insights about the performance of JabRef:

Preliminary tests have been carried out on a database with 100000 entries (is it big enough for you?). They show that JabRef is now 10 times faster at searching: it takes only one second to search through 60000 entries.

If you want to give it a try: http://builds.jabref.org/master/ (this is a development version. So, be carefully, and back up your data!). Your comments are welcomed at JabRef/jabref#1100

About opening large databases: work is under way to speed it up You can follow this development at JabRef/jabref#1094

Links -> Resources gives 404

Currently redirecting to https://docs.jabref.org/resources

Not sure where It should refer to

Add screenshots?

• Observation 1: Currently, there is no screenshot of the JabRef GUI on the website.
• Observation 2: A few screenshots (V 3.0) are on the old (sourceforge) wiki: http://sourceforge.net/p/jabref/wiki/Main_Page/ , so they are not easy to access
• Observation 3: screenshots on wikipedia are outdated (https://commons.wikimedia.org/w/index.php?title=Special%3ASearch&profile=default&search=jabref+screenshot&fulltext=Search&uselang=en )

Hence, it is difficult for potential users to see what JabRef looks like before making their decision to try it.

I believe we need to add up-to-date screenshots in an visible place.
Do you agree?

In such a case:

• Which place?
  • www.jabref.org? (where?)
  • Wikipedia?
  • Other?
• Which screenshots?
  • Which windows?
  • Screenshots from different OS? (some users are sensitive to a good visual integration)

Old JabRef icon in browser tab

The old JabRef icon is displayed in the browser tab.

Project of blog post: Highlighting of differences in merge entries

I am planning to write a blog post about the feature "Added highlighting of differences in merge entries dialogs and made s… #1022" (JabRef/jabref#1022).

The goals are:

• to present this coming feature (with screenshots)
• to show users that JabRef development never stops
• to ask users for testing this new feature and give feedback (especially about the preferred difference mode)

Intended release around May 10.

Comments and ideas welcome (before I start writing a first draft; to be submitted as an issue).

Update homepage with release of 4.0

This is just to track that we need to do a few documentation updates when we release 4.0.

The first thing that comes to my mind are the screenshots of JabRef that we show at the top of our homepage here: http://www.jabref.org/ The entry editor looks new and that should be reflected.

Give facelift

The design of our webpage need a facelift in my opinion.

• Templates:

  • https://y7kim.github.io/agency-jekyll-theme/
  • https://jekyllthemes.io/theme/creative-theme-jekyll
  • http://shaneweng.com/landing-page-theme/
  • https://jekyllthemes.io/theme/landing-page-theme
  • https://jekyllthemes.io/theme/hydra-jekyll-theme

• inspiration

  • --> https://junolab.org/
    • --> https://www.google.com/chrome/
  • http://www.styleshout.com/demo/?theme=lhander
  • http://electron.atom.io/
  • https://code.visualstudio.com/
  • https://www.drawboard.com/pdf/
    • https://getmemex.com/
  • https://chocolatey.org/
  • https://getpocket.com/
  • https://www.hubspot.com/crm/e010a?utm_content=e010a&utm_source=facebook.com&utm_campaign=Facebook-IntNonEngSpeaking-AllLaLs-2P-AllSegs-Desktop&utm_medium=paid&utm_term=crm&utm_id=e616a4v4
  • -> http://flarum.org/features/
  • -> https://www.amazon.com/b?ie=UTF8&node=16571048011&tag=aboutcom02lifewire-20
  • https://lavalite.org/
  • https://getmusicbee.com/
  • https://www.arduino.cc/en/Main/Software
  • https://todoist.com/
  • https://www.visualstudio.com/vs/#tab-c0c537cf292b435612f
  • https://www.behance.net/gallery/48964477/Landing-Page-Concept
  • https://lingvist.com/
  • https://www.elsevier.com/solutions/pure/who-uses-pure/librarians
  • https://www.citavi.com/en/features.html
  • https://www.shiftyjelly.com/pocketcasts/
  • https://material.io/
  • https://www.zotero.org/
  • https://atom.io/
  • https://lineageos.org/
  • https://ticktick.com/about/windows
  • https://hellonext.co/
  • https://kodi.tv/download
    • -> https://typora.io/
  • -> https://www.notion.so/product
    • -> https://www.mendeley.com/guides/mendeley-reference-manager

Pictures:

• https://www.ahmetertug.com/works/libraries/

Add search to help

http://help.jabref.org/ should be searchable.

FAQ: Windows: Q&A to be removed or updated

In the windows section of the FAQ, some Q&A seems quite old or to require an update.

Q: JabRef does not start on Windows 8, 64bit

A: This has been resolved in JabRef 2.9.1.

==> Quite old... To be removed?

Q: My virus-scanner tells me that JabRef is a virus. Is your server compromised?

A: No.
But the windows installer uses the Nullsoft Scriptable Install System (NSIS) version 2.18 (as of JabRef 2.1)

==> Even older... To be removed?

Q: How can I use JabRef as backend for Microsoft Word?

A: [...] The last option is to use Docear4Word, which is planned to be ported to JabRef.

==> What is the current status of https://github.com/JabRef/JabRef4Word ? Shouldn't it be mentioned?

Site is broken

Site is currently totally broken: