Lapikud / lapikud.github.io

Lapikute avalik koduleht
https://www.lapikud.ee
MIT License
2 stars 12 forks source link
siseprojekt

Lapikute väliveeb

Tegu on Jekyll peale ehitatud uhiuue lehega

Development plan

Materials are on Google Drive > Lapikud > Tarkvara > Väliveeb

Contribution guide

1. Create Issues

Easiest way to help would be to create issues about things that are missing and wrong

2. Fork this repo and create a pull request

Fork this repo to your own account and create a pull request for changes you have done in there

How to setup development environment

Windows:

  1. Install the Windows Subsystem for Linux

    Install Ubuntu

    https://docs.microsoft.com/en-us/windows/wsl/install-win10

  2. Install Ruby

    sudo apt install build-essential ruby ruby-dev dh-autoreconf
  3. Install Jekyll

    sudo gem install jekyll
  4. Clone repo

    git clone https://github.com/Lapikud/lapikud.github.io.git
  5. Serve the page (Use bash if on Windows)

    cd lapikud.github.io
    jekyll serve --host 0.0.0.0
  6. Image converter usage (requires imagemagick)

    No one wants to download 5MB images that are then shown in a 100x100px box.

    Always resize images before committing them!

    sudo apt-get install imagemagick
    sh convert-past-management-images.sh

MacOS:

  1. Install Homebrew if you don't have it already

    If you're using Bash, write /bin/bash instead of /bin/zsh.

    /bin/zsh -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. Install the latest stable version of Ruby

    brew install ruby

    Also configure your shell environment. If you're using Bash, replace .zshrc with .bash_profile.

    if [ -d "/usr/local/opt/ruby/bin" ]; then
        export PATH=/usr/local/opt/ruby/bin:$PATH
        export PATH=`gem environment gemdir`/bin:$PATH
    fi

    Check that Ruby is working.

    ruby -v
  3. Install the latest Jekyll gem

    sudo gem install jekyll
  4. Clone repo

    git clone https://github.com/Lapikud/lapikud.github.io.git
  5. Serve the page

    cd lapikud.github.io
    jekyll serve --host 0.0.0.0
  6. Image converter usage (requires imagemagick)

    No one wants to download 5MB images that are then shown in a 100x100px box.

    Always resize images before committing them!

    brew install imagemagick
    sh convert-past-management-images.sh

Deploy

Push to master branch and wait for deployment, it could take up to 2h for the page to update. You can check the progress by clicking on the environment link

Deployments link