This wiki is an open reference designed to compile and share terminologies used in the power systems engineering.
Language is inherently ambiguous, and power system terminologies are no exception. Inspired by an email titled “Definitions of Smart Grids a Decade Ago – What Has Changed?” on Power-Globe in 2024, I decided to compile terminologies from papers, standards, reports, and other traceable sources to build this wiki.
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.
Built upon the al-folio Jekyll theme, this website introduces significant enhancements, particularly in its new wiki section.
A custom wiki layout 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 term links
- Navigation: Previous/Next term links for easy Browse
- Direct Editing: A link to edit the term directly on GitHub
- Community Engagement: Integrated Giscus comments
The PS-Wiki REST API provides read-only access to term data in JSON format. It is deployed via Cloudflare Workers and documented using the OpenAPI 3.1.0 specification at https://pswiki-api.jinninggm.workers.dev/openapi.json
- All timestamps use ISO 8601 format (YYYY-MM-DD or full date-time).
- Pagination uses opaque cursors; pass
next_cursorto retrieve the next page. - The
/v1/termsand/v1/terms/{id}endpoints are suitable for integration with external AI clients.
The folder database contains the source data and scripts for generating the wiki:
- Folder
database/jsoncontains the source JSON files for the wiki. - Folder
database/pyscriptscontains Python scripts for processing the data.
Python dependencies are described in database/requirements.txt
Common commands for using the scripts are as follows:
Convert all JSON files to Markdown files in the _wiki folder:
python database/pyscripts/json2md_all.py --in-dir database/json --out-dir _wiki --pattern "*.json"Convert a single JSON file to a Markdown file:
python database/pyscripts/json2md.py --input database/json/stability.json --output _wiki/stability.mdThis project is licensed under the CC-BY-NC 4.0.