Stockholm AI website

The Stockholm AI website.

Local Debug Deploy

To serve the website without the nginx server

• Install Jekyll
• jekyll serve
• open localhost:4000 in your web browser

It is tested to work with jekyll 3.8.5

Full Local Debug Deploy

To serve the website as it is being deployed live, including the nginx server

• Install docker
• ./local_start.sh
• open localhost in your web browser

Troubleshoot

• Verify that your script actually continues to run (it should be in a so called watch-mode and react to changes in the filesystem)
• Verify that the script actually manages to compile the files. In the case of a compiltion error the script will continue to run but be unable to compile all the files needed.
• If you get permission errors and SELinux warnings (default in newer versions of Fedora for example). Set a security exception for the docker sandbox to access pwd by running

  chcon -Rt svirt_sandbox_file_t `pwd`
  

Contribution

If you would like to contribute with content or issues into this repo. Please take a look at our issue page.

We use Jekyll as our rendering tool. Quick introduction:

Example: "Changing the calendar html element to use ical

calendar.html           <-- provides the /route of calendar
_layouts/calendar.html  <-- gives the "layout of the calendar element
_includes/calendar.html <-- layout takes from _includes directory with the "meet" @jim
_data/*.yml             <-- for each page you have access to variables. Example {{ site.organization.title }}

More Help with Jekyll

For more details, read documentation

Debug

To see the jekyll value of a variable:

{{ variable | inspect }}

Deploy

• Install docker
• ./start.sh

Images

Resize Faces

convert first-last.jpg -resize 220x220 first-last.jpg

Resize photo

convert photo.jpg -resize 800 photo.jpg

and hold your thumbs that the height will be relatively sane.

Check size

ls img/category | xargs file

Logo

https://fedoraproject.org/wiki/Montserrat_Fonts

Install the used font (Fedora)

sudo dnf install julietaula-montserrat-fonts

Font style

Bold with letter spacing of font_size/12. The proportions between letter spacing 11.78 and font size 7.4191.

Find Dead Links

Install

pip install yaml requests

Run

python deadlinks.py

Changes to _config.yml [DEPRICATED]

NOTE: not applicable for start.sh, only jekyll serve Changes to _config.yml does not propagate automatically with jekyll serve, instead put changing data under _data and keep the truly static stuff in _config.yml. This also has the side-effect that if the _config.yml is missing when you start the jekyll build --watch it will just act like it's laking any data and kindly compile everything with missing data (hence the [[ -f _config ]] check in the start script.

Licensing

This code derives from y7kim/agency-jekyll-theme and is still distributed via Apache License Version 2.0 (See LICENSE for further information).

Changes from derived software

To view the changes made from the derived content:

git diff a6ddd100833e7e9f8aa786fec110d97260b76b55 master