Skip to content

Wiki layout metadata #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jun 22, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Power Systems Wiki

This wiki is an open reference designed to compile and share terminologies used in the power systems field.
This wiki is an open reference designed to compile and share terminologies used in the power systems engineering.

[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg)](https://github.com/ps-wiki/ps-wiki.github.io/blob/main/LICENSE)
[![Deploy site](https://github.com/ps-wiki/ps-wiki.github.io/actions/workflows/deploy.yml/badge.svg)](https://github.com/ps-wiki/ps-wiki.github.io/actions/workflows/deploy.yml)
Expand All @@ -15,9 +15,16 @@ Language is inherently ambiguous, and power system terminologies are no exceptio

We welcome contributions from the community! If you have suggestions, corrections, or new terms to add, please open an issue or submit a pull request.

## Website
## Website Overview

The website is adapted from the [al-folio](https://github.com/alshedivat/al-folio)
Built upon the [al-folio](https://github.com/alshedivat/al-folio) Jekyll theme, this website introduces significant enhancements, particularly in its new wiki section.

A custom [wiki layout](./_layouts/wiki.liquid) adapted from the `distill` layout, has been developed to effectively host item-based terminologies. Key features include:

- **Metadata Display**: Last update date, tags, and related item links
- **Navigation**: Previous/Next item links for easy Browse
- **Direct Editing**: A link to edit the item directly on GitHub
- **Community Engagement**: Integrated Giscus comments

## License

Expand Down
46 changes: 44 additions & 2 deletions _layouts/wiki.liquid
Original file line number Diff line number Diff line change
Expand Up @@ -68,9 +68,51 @@

<d-article>
{% if page.last_update %}
<p>Last Updated: {{ page.last_update | date: '%B %d, %Y' }}</p>
<hr style="margin:0.5em;">
<p><strong>Last Updated:</strong>&nbsp;&nbsp;{{ page.last_update | date: '%B %d, %Y' }}</p>
{% endif %}

{% if page.tags and page.tags != empty %}
<div class="wiki-tags-container d-flex align-items-center">
<div class="d-flex flex-wrap align-items-baseline">
<p><strong>Tags:</strong>&nbsp;&nbsp;</p>
{% for tag in page.tags %}
{% assign tag_url = tag | slugify | prepend: '/wiki-tag/#' %}
<a href="{{ tag_url | relative_url }}" class="wiki-tag-link text-decoration-none"> #&nbsp;{{ tag }} </a>
{%- if forloop.last == false %}&nbsp;&nbsp;{% endif %}
{% endfor %}
</div>
</div>
{% endif %}

{% if page.related and page.related != empty %}
<div class="wiki-related-container d-flex align-items-center mb-4">
<div class="d-flex flex-wrap align-items-baseline">
<p><strong>See Also:</strong>&nbsp;&nbsp;</p>
{% for related_slug in page.related %}
{% assign found_related_page = null %}
{% for wiki_page_item in site.wiki %}
{% assign wiki_page_slug = wiki_page_item.url | split: '/' | last | replace: '.html', '' %}
{% if wiki_page_slug == related_slug %}
{% assign found_related_page = wiki_page_item %}
{% break %} {# Found it, exit inner loop #}
{% endif %}
{% endfor %}

{% if found_related_page %}
<a href="{{ found_related_page.url | relative_url }}" class="wiki-related-link text-decoration-none">
{{ found_related_page.title }}
</a>
{%- unless forloop.last %}&nbsp;&nbsp;{% endunless %}
{% else %}
{# Optional: Display a warning if a related page slug is not found #}
<span class="text-danger" title="Related page not found: {{ related_slug }}">{{ related_slug }} (Not Found)</span>
{%- unless forloop.last %},&nbsp;{% endunless %}
{% endif %}
{% endfor %}
</div>
</div>
{% endif %}

{% if page.toc %}
<d-contents>
<nav class="l-text figcaption">
Expand Down
7 changes: 4 additions & 3 deletions _wiki/30-minutes-reserve-service.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,16 @@ description: Can be satisfied by online or offline resources that are able to re
tags:
- reserve
- system-operator
- pjm
related:
- contingency-reserve
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency Reserve](/wiki/contingency-reserve)

### Definition By PJM

Source: <d-cite key="pjm2024m10"></d-cite> p27, Revision 45
Expand Down
11 changes: 8 additions & 3 deletions _wiki/automatic-generation-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,20 @@ tags:
- frequency-control
- ferc
- nerc
related:
- fast-frequency-response
- primary-control
- secondary-control
- tertiary-control
- frequency-regulation
- frequency-stability
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Fast Frequency Response](/wiki/fast-frequency-response) &nbsp; [Primary Control](/wiki/primary-control) &nbsp; [Secondary Control](/wiki/secondary-control) &nbsp; [Tertiary Control](/wiki/tertiary-control) &nbsp; [Frequency Regulation](/wiki/frequency-regulation) &nbsp; [Frequency Stability](/wiki/frequency-stability)

### Definition By NERC

Source: <d-cite key="nerc2024glossary"></d-cite>
Expand Down
3 changes: 2 additions & 1 deletion _wiki/co-located-load.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,12 @@ tags:
- load
- transmission
- system-operator
- pjm
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

### Definition by PJM
Expand Down
3 changes: 2 additions & 1 deletion _wiki/compliance-factor.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@ description: CF.
tags:
- frequency-control
- system-operator
- pjm
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

### Definition by PJM
Expand Down
6 changes: 3 additions & 3 deletions _wiki/contingency-analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ description: Procedures to study a contingency.
tags:
- contingency
- system-operator
related:
- contingency-list
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency List](/wiki/contingency-list)

### Definition by ISO-NE

Source: <d-cite key="isone2024crop34007"></d-cite>
Expand Down
10 changes: 7 additions & 3 deletions _wiki/contingency-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,19 @@ description: A list of network elements to be simulated as disconnected.
tags:
- contingency
- system-operator
- isone
- pjm
- entsoe
related:
- contingency-analysis
- contingency
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency](/wiki/contingency)

### Definition by ISO-NE

Source: <d-cite key="isone2024op19j"></d-cite>
Expand Down
7 changes: 4 additions & 3 deletions _wiki/contingency-reserve-service.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,16 @@ tags:
- reserve
- system-operator
- contingency
- pjm
related:
- contingency-reserve
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency Reserve](/wiki/contingency-reserve)

### Definition by PJM

Source: <d-cite key="pjm2024m10"></d-cite> p26, Revision 45
Expand Down
6 changes: 3 additions & 3 deletions _wiki/contingency-reserve.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ description: Capacity deployed by the Balancing Authority to meet the Disturbanc
tags:
- nerc
- contingency
related:
- contingency-reserve-service
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency Reserve Service](/wiki/contingency-reserve-service)

### Definition by NERC

Source: <d-cite key="nerc2024glossary"></d-cite>
Expand Down
8 changes: 5 additions & 3 deletions _wiki/contingency.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,17 @@ tags:
- contingency
- system-operator
- nerc
related:
- emergency
- contingency-analysis
- contingency-list
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Emergency](/wiki/emergency)

### Definition by ISO-NE

Source: <d-cite key="isone2024op19"></d-cite> p6, Revision 13.3
Expand Down
7 changes: 6 additions & 1 deletion _wiki/control-area.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,19 @@
---
title: Control Area
description: A.k.a. Balancing Authority Area.
related:
- balancing-authority-area
- region
- zone
- subregions
tags:
- geography
- ferc
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

### Definition by FERC
Expand Down
5 changes: 4 additions & 1 deletion _wiki/day-ahead-energy-market.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,14 @@ description: Forward markets for electricity to be supplied the following day.
tags:
- system-operator
- market
- nyiso
- pjm
- ferc
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevante items: [Security Constrained Unit Commitment](/wiki/security-constrained-unit-commitment) &nbsp; [Security Constrained Economic Dispatch](/wiki/security-constrained-economic-dispatch) &nbsp; [Locational Marginal Price](/wiki/locational-marginal-price) &nbsp; [Energy Market](/wiki/energy-market)
Expand Down
4 changes: 3 additions & 1 deletion _wiki/distribution-factors.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,13 @@ title: Distribution Factors
description: DFAX.
tags:
- sensitivity
- system-operator
- pjm
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

### Definition by PJM
Expand Down
8 changes: 5 additions & 3 deletions _wiki/emergency.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,17 @@ tags:
- transmission
- nerc
- reliability
- pjm
- emergency
related:
- contingency
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Contingency](/wiki/contingency)

### Definition by NERC

Source: <d-cite key="nerc2024glossary"></d-cite>
Expand Down
8 changes: 5 additions & 3 deletions _wiki/fast-frequency-response.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,17 @@ tags:
- inertia
- frequency-control
- system-operator
related:
- primary-control
- secondary-control
- frequency-stability
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Primary Control](/wiki/primary-control) &nbsp; [Secondary Control](/wiki/secondary-control) &nbsp; [Tertiary Control](/wiki/tertiary-control) &nbsp; [Frequency Regulation](/wiki/frequency-regulation) &nbsp; [Automatic Generation Control](/wiki/automatic-generation-control) &nbsp; [Frequency Stability](/wiki/frequency-stability)

### Definition in a NERC Webinar by ERCOT

Source: <d-cite key="nerc2020ffr"></d-cite>
Expand Down
3 changes: 2 additions & 1 deletion _wiki/flexibility-reserve.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,12 @@ tags:
- flexibility
- reserve
- system-operator
- nyiso
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-18
last_update: 2025-06-22
---

### Definition by NYISO
Expand Down
10 changes: 7 additions & 3 deletions _wiki/frequency-regulation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,19 @@ tags:
- frequency-control
- balancing-authority
- nerc
related:
- fast-frequency-response
- primary-control
- secondary-control
- tertiary-control
- automatic-generation-control
authors:
- name: Jinning Wang
url: https://jinningwang.github.io
date: 2025-03-15
last_update: 2025-06-20
last_update: 2025-06-22
---

Relevant items: [Fast Frequency Response](/wiki/fast-frequency-response) &nbsp; [Primary Control](/wiki/primary-control) &nbsp; [Secondary Control](/wiki/secondary-control) &nbsp; [Tertiary Control](/wiki/tertiary-control) &nbsp; [Automatic Generation Control](/wiki/automatic-generation-control) &nbsp; [Frequency Stability](/wiki/frequency-stability)

### Definition by NERC

Source: <d-cite key="nerc2024glossary"></d-cite>
Expand Down
Loading