Website Updates HOWTO

How to edit the HamWAN home page

Before starting, ensure your ssh key is authorized to access kiss@kiss.hamwan.org.

Ubuntu based setup

sudo apt install -y git pandoc python2.7 python2-pip-whl python2-setuptools-whl virtualenv r-base r-cran-plotrix libnumber-bytes-human-perl libjson-perl bc rsync

Fedora based setup

sudo dnf install -y git pandoc python2.7 virtualenv python3-pip R-core perl-Number-Bytes-Human perl-JSON perl-XML-Twig rsync
echo 'install.packages("plotrix", repos="https://cloud.r-project.org/")' | sudo R --save
sudo firewall-cmd --add-port=8000/tcp
mkdir -p ~/.ssh

Generic build steps

echo -e "Host kiss.hamwan.org\n HostKeyAlgorithms +ssh-rsa\n PubkeyAcceptedAlgorithms +ssh-rsa\n StrictHostKeyChecking=no" >> ~/.ssh/config
git clone kiss@kiss.hamwan.org:kiss.git
cd kiss
virtualenv -p `which python2.7` venv
. venv/bin/activate
pip install -r requirements.txt
./run_test_srv.sh

To exit the virtual environment type "deactivate".

Generic git usage

Setup your git global variables.

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Create a branch to hold your proposed changes.

git checkout -b add-new-filename-page

Edit your files and commit your change.

vi src/filename.md
git add src/filename.md
git status
git commit

Push your changes to the KISS server for review and merging.

git push -u origin add-new-filename-page

An email will be sent automatically to netops to review your new branch. Once approved, it'll be merged into the master branch and your branch will be deleted. You can then safely delete your local branch.

git switch master
git branch -d add-new-filename-page