Peace Development Fund – UN Modelling Project

Website Repository

---

This repository hosts the source code for the Peace and Development Fund (PDF) – UN Modelling Project website.

The official website is available at:
👉 https://desa-eapd.github.io/modelling-project/

The site is built with Jekyll using the Jekyll Advance Pro Theme, and is designed to present:

• project information
• country and thematic updates
• modelling results and policy simulations
• newsletters and knowledge products

in a structured and accessible way for policymakers, partners, and stakeholders.

This repository was created and is maintained by Nyein Chan Kyaw (DESA\EAPD).

---

1. Project Overview

Project Title

Rebuilding better and greener from the COVID-19 pandemic through enhanced design and implementation of sustainable national recovery strategies based on policy simulations

Objective

Strengthen the capacity of government agencies to better utilize data and analytical tools to inform national development strategies through quantitative modelling.

Duration

2023–2027

Target Countries

TBD

Main Activities

• Identify planning and data gaps where modelling can enhance decision-making
• Assess and customise modelling approaches (macro, micro-simulation, CLEWS)
• Conduct workshops and modelling capacity development
• Provide technical and advisory support to national governments
• Produce policy documents informed by simulation results
• Support participation in UN-level dialogues (ECOSOC, HLPF, etc.)
• Publish modelling outputs, newsletters, and reports

---

2. Theme: Jekyll Advance Pro

Jekyll Advance Pro is a premium multi-purpose theme designed for structured content, clean design, and scalable websites.

• Live Demo: https://jekyll-advance.netlify.app/
• Documentation: https://www.zerostatic.io/docs/jekyll-advance/

The project uses the theme to:

• Manage blog posts through collections (_posts)
• Generate category-based navigation
• Implement structured pages for project documentation
• Publish newsletters and modelling updates
• Render HTML through templates in _layouts

---

3. Repository Structure

.
├── collections/
│   ├── _posts/          # Blog/news posts and updates
│   ├── news/            # Newsletters and periodic publications
│   └── …                # Additional collections as required
│
├── pages/               # Static pages
│
├── categories/          # Category landing pages for filtering
│
├── assets/
│   └── images/
│        └── gen/
│             ├── blog/    
│             ├── content/ 
│             └── home/    
│
├── _layouts/            # Liquid/HTML templates
│
├── _config.yml          # Jekyll configuration
└── README.md

---

3.1 Posts (collections/_posts)

Used for:

• Project & Modelling updates
• Country activities
• Training summaries

Naming format:

YYYY-MM-DD-title.md

Example: 2025-11-17-og.md

---
layout: post
title: "Project Launch and Initial OG-Core Training Workshop in Ethiopia"
date: 2025-11-17
authors: ["UNDESA"]
categories: ["OG-Core", "Ethiopia"]
tags: [og model]
description: "Strengthening Ethiopia’s Economic Planning Capacity Through Advanced Policy Simulation Tools."
thumbnail: "/assets/images/gen/blog/og_model_ethiopia_thumbnail.png"
---

---

3.2 Pages (pages/)

For static project information pages.

Example:

---
layout: project
title: "About the Modelling Project"
permalink: /about/
---

---

3.3 Categories (categories/)

Each category page is a filtering template.

Example:

---
layout: category
title: "Philippines"
category: philippines
---

---

3.4 Newsletters (collections/news)

Store newsletters as:

• PDF

Naming examples:

newsletter_may2025.pdf
newsletter_oct2024.pdf

---

3.5 Images (assets/images/gen)

Subfolders:

• blog/ – images used in posts
• content/ – illustrations inside pages
• home/ – homepage hero and section images

Example reference:

![Og-Core](https://desa-eapd.github.io/modelling-project/assets/images/gen/blog/og-south-africa1.jpeg)

---

3.6 Layouts (_layouts)

Templates available include:

• default.html
• post.html
• category.html
• project.html
• home.html
• custom modelling layouts (e.g., wefm.html)

Markdown files declare layout via front matter:

layout: post

---

4. Getting Started

4.1 Install Jekyll

Ensure Ruby and Jekyll are installed. Guide: https://jekyllrb.com/docs/installation/

4.2 Install Dependencies

bundle install

4.3 Run the Site Locally

bundle exec jekyll serve

Local preview: http://localhost:4000

4.4 Build Static Site

bundle exec jekyll build

Outputs to _site/.

---

5. Content Authoring Workflow

5.1 Create a New Post

Steps:

1. Add .md file in collections/_posts/
2. Apply correct naming convention
3. Add front matter
4. Write content
5. Push to repository

---

5.2 Create a New Page

Example template:

---
layout: project
title: "New Page"
permalink: /new-page/
---

---

5.3 Add a Newsletter

1. Add PDF file into collections/news/
2. Link from newsletter index page if needed

---

5.4 Add Images

Place in:

assets/images/gen/[blog|content|home]

---

5.5 Create a New Category

---
layout: category
title: "Jordan"
category: jordan
---

Tag related posts:

category: jordan

5.6 Add OG-CORE Workshop Presentations

OG-CORE workshop presentations are stored and published externally through the repository at:

https://eapd-drb.github.io/og-model/

This site hosts country-specific folders containing PDF and other workshop materials.
Each country presentation page in this Jekyll site should link directly to these external files.

Upload new workshop presentations into the appropriate country folder in:

---
[https://github.com/eapd-drb/og-model/](https://github.com/eapd-drb/og-model/)
---

Country folder examples:

```yaml
---
/south-africa/
/indonesia/
/philippines/
---

Example file:

---

/south-africa/ZAF-PolicyBrainstorm.pdf
---

Example:

---
[https://eapd-drb.github.io/og-model/south-africa/ZAF-PolicyBrainstorm.pdf](https://eapd-drb.github.io/og-model/south-africa/ZAF-PolicyBrainstorm.pdf)

---

Add links to the presentation files in the country page

Each country has a Markdown page (e.g., south-africa.md) that serves as the presentation hub.

In og-workshop-info.md, update the workshop section:

### Module 1: Initial Training Workshop

- [Presentations – South Africa](/og-workshop/south-africa/)
- [Presentations – Indonesia](/og-workshop/indonesia/)
- [Presentations – Philippines](/og-workshop/philippines/)

---

6. Jekyll Configuration Cheat Sheet (_config.yml)

# Site identity
title: "Peace Development Fund – UN Modelling Project"
description: "Rebuilding better and greener through quantitative policy simulations."
url: "https://desa-eapd.github.io"   
baseurl: "/modelling-project"       
timezone: "UTC"
lang: "en"

# Theme
theme: jekyll-advance-pro
markdown: kramdown
highlighter: rouge

# Permalinks
permalink: /:categories/:year/:month/:day/:title/

# Collections
collections:
  posts:
    output: true
    permalink: /blog/:year/:month/:day/:title/
  news:
    output: true
    permalink: /news/:path/

# SASS
sass:
  style: compressed

# Exclusions
exclude:
  - README.md
  - Gemfile
  - Gemfile.lock
  - vendor
  - node_modules

---

7. Deployment

7.1 Netlify

Theme includes a working netlify.toml. Guide: https://docs.netlify.com/site-deploys/create-deploys/

If gem installation fails: delete Gemfile.lock.

7.2 GitHub Pages

Guide: https://jekyllrb.com/docs/github-pages/

Project Pages require:

• url: https://username.github.io
• baseurl: /repository-name

---

8. Contributing

• Follow naming conventions
• Maintain clean front matter
• Use correct image locations
• Maintain consistent layouts
• Open issues for PR changes

---

9. Credits

Font Awesome 5 Free

https://fontawesome.com/

Unsplash Demo Images

https://unsplash.com/

License: https://unsplash.com/license