Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mingw-w64/mingw-w64.github.io

mingw-w64.net web page contents (The new web page)
https://github.com/mingw-w64/mingw-w64.github.io

Last synced: about 2 months ago
JSON representation

mingw-w64.net web page contents (The new web page)

Awesome Lists containing this project

README

        

# MinGW-w64 Website

This website is written in Markdown and gets built to a static website using
[mkdocs](https://www.mkdocs.org/) and a modified version of the [mkdocs-material
theme](https://squidfunk.github.io/mkdocs-material). The main branch of this
repo is the `source` branch and any new commits will auto deploy a new build to
the `main` branch using [a GitHub
action](https://github.com/peaceiris/actions-gh-pages). The `main` branch is
connected to [GitHub pages](https://pages.github.com) and is reachable under
https://mingw-w64.github.io and https://www.mingw-w64.org. Changes to the
`source` branch usually take a minute or two until they are live.

## Development

For small changes:

* Just use the online editor on GitHub and use the Markdown preview to inspect your changes
* Open a PR with your changes in case you don't have commit rights
* **Note:** The Markdown dialect and extensions understood by mkdocs and GitHub is
slightly different, so double check that the deployed website matches what you
expected
* **Note:** Every page on the website has a small "edit" icon in the top right corner which leads you straight to the online editor for that page

For larger changes:

* `poetry install`
* `poetry run mkdocs serve`
* Access http://127.0.0.1:8000 - any changes to the sources should be
immediately visible in your browser
* Open a PR with your changes or just push them if you have commit rights