mxmehl
/
fsfe-local-build
spegling av https://git.fsfe.org/FSFE/fsfe-local-build.git
Bevaka 1
Stjärnmärk 0
Förgrening 0
Kod Ärenden 0 Släpp 1 Wiki Aktiviteter
Ingen beskrivning
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.
26 Incheckningar
3 Grenar
Gren: master
Grenar Taggar
${ item.name }
Skapa branchen ${ searchTerm }
från 'master'
${ noResults }
fsfe-local-build
Reinhard Müller 0953ce99bb Add new script to build everything that is not up to date 1 månad sedan
status change ignoring and keeping of folders to prevent dirty directories when dealing with the fsfe-website git and its .gitignore 1 år sedan
.gitignore Add a docker dev setup (#3) 1 år sedan
Dockerfile Removes less from docker (#5) 1 år sedan
LICENSE adding README and license 3 år sedan
README.md Add a docker dev setup (#3) 1 år sedan
config.cfg.docker Add a docker dev setup (#3) 1 år sedan
config.cfg.sample fix paths 1 år sedan
create-mime.assign.pl initial commit 3 år sedan
docker-cmd.sh Removes less from docker (#5) 1 år sedan
docker-compose.yml Add a docker dev setup (#3) 1 år sedan
docker-setup.sh Replace /bin/bash with /usr/bin/env bash (#4) 1 år sedan
fsfe-build.sh Add new script to build everything that is not up to date 1 månad sedan
fsfe-preview.sh Symlink instead of copy static files to destination 1 år sedan
lighttpd-fsfe.conf.sample fix paths 1 år sedan
pywebserver-fsfe.py adding option to use python simplehttp webserver module which doesn't require users to install lighttpd 3 år sedan

README.md

FSFE Website Local Build

This is a collection of scripts, tools and configuration files necessary to build fsfe.org websites locally.

Full instructions can be found in FSFE’s wiki: https://wiki.fsfe.org/TechDocs/Mainpage/BuildLocally

Docker based development environment

For convenience local development you may want to use the docker contaienr provided by this repo.

The container contains everything you need to work on the website including serving a preview, building the static pages and the CSS files.

Requirements

Website Dev Instructions

Initial set up

Just run the following command for the initial setup:

./docker-setup.sh

⚠ The command may run some hours, since it does the initial full build of the website.

Development

Spin up the container (⚠ takes some minutes):

docker-compose up

The website should now be available on your machine under http://127.0.0.1:8000/.

Build a single page after changes (e.g. index.de.xhtml):

docker exec \
    --workdir /fsfe-local-build/fsfe.org \
    fsfe-local-build \
    bash ../fsfe-preview.sh ../fsfe-website/index.de.xhtml

Style modifications in fsfe-website/look trigger a re build of the styles. After modifications a page reload shoud show the changes.