The F-Droid Website

This is the repository for the website at https://f-droid.org. It is based on Jekyll and you can find the development version here.

Building

Using Debian/buster

First, make sure buster-backports is enabled.

sudo apt-get install -t buster-backports \
  gettext linkchecker po4a python3 python3-babel rsync rubocop ruby-bundler \
  ruby-git ruby-jekyll-include-cache ruby-jekyll-paginate-v2 \
  ruby-jekyll-redirect-from ruby-json ruby-loofah ruby-rchardet ruby-rouge \
  ruby-rspec ruby-zip unzip
bundle install --local
jekyll build

If you experience an error during the build process, try also:

bundle update

Look at the .gitlab-ci.yml for more examples of custom setups, like building only a subset of the languages.

Using Ruby Gems

You need to have Jekyll 3.2+ installed what is easily done with Gem which depends on Ruby 2.0+. Because of the F-Droid plugin you need to have zlib installed.

sudo apt-get install build-essential git ruby-full zlib1g-dev
sudo gem install bundler
bundle install

To build the website, run:

bundle exec jekyll build

If you want to build the website and serve it with a local server at localhost:4000, use:

bundle exec jekyll serve

Using a Vagrant VM

Vagrant makes it easy to setup and destroy VMs. That is handy for making a clean and predictable build environment, regardless of the base system. If used with VirtualBox, then the current directory will be shared into the VM, so you can edit locally, and have jekyll serve running in the VM.

$ vagrant up
$ vagrant ssh
vagrant@buster:~$ cd /vagrant
vagrant@buster:/vagrant$ bundle install --local
vagrant@buster:/vagrant$ jekyll serve --host 0.0.0.0

Then connect to http://localhost:4000 to see the generated site.

Local development

  • Clone F-Droid's Jekyll plugin
  • Configure bundle to use it: bundle config --local local.jekyll-fdroid ../jekyll-fdroid
  • Follow the steps above

If you want to use the official Git repository again, run bundle config --delete local.jekyll-fdroid.

Alternatively you may also set the jekyll-fdroid dependeny line in Gemfile to your local clone, e.g.: gem 'jekyll-fdroid', :path => './jekyll-fdroid'

License

This program is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Translation

Everything on this website can be translated. See Translation and Localization for more info. The staging site includes all translations, whether they are complete or not.

chrome strings

pages

tutorials

documentation

blog posts