/aem.design

AEM.Design blog

Primary LanguageHTMLApache License 2.0Apache-2.0

aem.design

AEM.Design blog

build_status github license github issues github last commit github repo size statuscake Visit AEM.Design Gitter Keybase

Updating this Repo

You can update this repo using your favorite IDE or use a web based editor

Markdown Cheatsheet

When creating pages in this repo use the markdown syntax, you can find syntax here:

Icons

Icons can be selected form here Fontawesome

Getting Started

  • ensure you have Git LFS installed

  • run server while editing

./serve.sh

Convert images to WebP

If you want to convert your images to webp follow this and commit outputs:

  • run container using start.ps1
  • change to source dir
  • run ./webp.py <asset path>

On Windows

On windows, for best results use docker for everything.

#POWERSHELL
docker run -it --rm -p 4000:4000 -p 35729:35729 -v ${pwd}:/build/source:rw aemdesign/centos-java-buildpack bash --login

cd source/
rvm install "ruby-2.6.3"
gem install jekyll bundler jemoji nokogiri -n /usr/local/bin
bundle install
bundle exec jekyll serve --host 0.0.0.0 --livereload

Google Ads

Config is located in _data/advertising.yml html should not need to be changed and located in _includes/adds/adsense.html

Project Structure Description

Following is the description of important sections in the project.

  • assets - folder for all assets that appear on the site
  • _archive - pages that have been referenced and migrated from the internet to ensure they keep existing
  • _posts - location for all Blog posts, add your markdown here and create a subfolder in assests for all your images etc
  • _manual - folder for the Manual section of the site
  • _manifesto - folder for the Manifesto section of the site
  • _layouts - templates for pages
  • _docs - general info pages
  • _pages - admin pages for site
  • _data - data config for page modules
  • _config.yml - primary config for whole site

Additional Notes

  • all items with _ (underscore) are essentially hidden.
  • to add new sections and items to navigation _config.yml and _data/navigation.yml should be updated