HOW_TO.md

How To

Update Dependencies

bundle update

Update Gems

gem update
gem update --system

Add a new section (folder)

1. Create a new folder starting with an underscore (and with a name that is not reserved for Jekyll)

2. Add a new entry in _config.yml under collections using the same name without the leading underscore (and without any content).

   collections:
     new_section:

3. Create a new new_section.html file in the paths folder. Remember to change the name in the permalink and the for-loop at site.new_section.

   ---
   layout: tips
   title: The New Section
   permalink: /new-section/
   ---
   
   <h2>The New Section</h2>
   <ul>
     {% for tip in site.new_section %}
     <li>
       <p>{{ tip.content | markdownify }}</p>
       <hr />
       <hr />
     </li>
     {% endfor %}
   </ul>

4. Add the link to index.md:

   <a href="/new-section">New Section</a> <br />

Add a permalinked post to the header

Simply give it a property of

include_in_header: true

Modify the layout

see https://jekyllrb.com/docs/themes/#overriding-theme-defaults