mxmehl
/
fsfe-local-build
mirror of https://git.fsfe.org/FSFE/fsfe-local-build.git
1
0
Fork 0
Code Issues Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
30 Commits
3 Branches
1 Tag
65 KiB
 
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
max.mehl 095ed704ce
create destination directory if necessary. Also rename SVN->Git 		2 years ago
status change ignoring and keeping of folders to prevent dirty directories when dealing with the fsfe-website git and its .gitignore 5 years ago
.gitignore ignore optional php error log 3 years ago
Dockerfile Removes less from docker (#5) 4 years ago
LICENSE adding README and license 7 years ago
README.md Add a docker dev setup (#3) 4 years ago
config.cfg.docker Add a docker dev setup (#3) 4 years ago
config.cfg.sample fix paths 5 years ago
create-mime.assign.pl initial commit 7 years ago
docker-cmd.sh Removes less from docker (#5) 4 years ago
docker-compose.yml Add a docker dev setup (#3) 4 years ago
docker-setup.sh Replace /bin/bash with /usr/bin/env bash (#4) 4 years ago
fsfe-build.sh Add --full option for fsfe-build.sh 2 years ago
fsfe-preview.sh create destination directory if necessary. Also rename SVN->Git 2 years ago
lighttpd-fsfe.conf.sample fix paths 5 years ago
pywebserver-fsfe.py adding option to use python simplehttp webserver module which doesn't require users to install lighttpd 7 years ago

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.