暂无描述
您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
Michael Weimann 294a2ff8b0 Removes less from docker (#5) 3 个月前
status change ignoring and keeping of folders to prevent dirty directories when dealing with the fsfe-website git and its .gitignore 9 个月前
.gitignore Add a docker dev setup (#3) 4 个月前
Dockerfile Removes less from docker (#5) 3 个月前
LICENSE adding README and license 2 年前
README.md Add a docker dev setup (#3) 4 个月前
config.cfg.docker Add a docker dev setup (#3) 4 个月前
config.cfg.sample fix paths 9 个月前
create-mime.assign.pl initial commit 2 年前
docker-cmd.sh Removes less from docker (#5) 3 个月前
docker-compose.yml Add a docker dev setup (#3) 4 个月前
docker-setup.sh Replace /bin/bash with /usr/bin/env bash (#4) 3 个月前
fsfe-preview.sh Symlink instead of copy static files to destination 3 个月前
lighttpd-fsfe.conf.sample fix paths 9 个月前
pywebserver-fsfe.py adding option to use python simplehttp webserver module which doesn't require users to install lighttpd 2 年前

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.