[This repository]({{ site.github.repository_url }}) is a template for web site generation with MD files.
this repository generate a 3 level website :
Simply for visibility reasons. Markdown / text files are simple to use and maintain in a repository but we can only read them when we stay on repository platform.
It's not as visible on search engines than websites.
Creating the website from MD files is a sort of best of 2 worlds : MD files maintaining on Github is simple, generating the website is automatic, and we can use this website on GitHub Pages as any other website with links, SEO and SEA.
Copy this repository template as a new repository directly from GitHub.
Remove "/.github" folder or change the sponsor links in it (don't lets mine on your repos !).
Edit or remove CONTRIBUTING.md (update the "family" property values depanding on your needs) and CODE_OF_CONDUCT.md files.
Change the copyright in "/includes/footer.html" file if needed. By default it displays datas from your GitHub repository datas.
Edit the "/index.html" file to change it's "title" property.
Copy templates files (and rename copies) from "/_template_files_for_data_collections" folder to :
After adapting your "css/styles.css" file, activate GitHub Pages on your repository (go to "Settings / Pages" for that).
GitHub will launch Jekyll on your repository from a GitHub action and generate a website each time you push your commits.
GitHub allow us to use our domaine name for free. For SEO reasons it's better than a subfolder on github.io domain. Do it if you want to share your work with the rest of the world !
As web site content, simply create a new file in "/_data_languages" folder by copying an existing one or the template.
As web site language you can copy one file from "/_translated_texts" and translate it.
In the two cases you need a flag. Check if it's already available in "/images" folder or add a new one.
This repository was done after creating three "learning resources" websites for Delphi, Lazarus and Pascal language because I think it's simple to personalize and easy to use.
The original standard texts where translated from FR or EN to CN, DE, DK, HU, JP, PL, RU, SE, SP and TR with Deepl translation service.
If you like this project and if you use it, tell it.
And if you can please thinks about sponsoring my activities on the web (see links on GitHub) and perhaps subscribing to my Zone-Abo membership program.
You can contact me from one of my web site, [open a new discussion]({{ site.github.repository_url }}/discussions) or [create an issue]({{ site.github.issues_url }}) if you want to talk or report anything about this project.
If you think this project is useful and want to support it, please make a donation to its author. It will help to maintain the code and binaries.
You can use one of those services :
or if you speack french you can subscribe to Zone Abo on a monthly or yearly basis and get a lot of resources as videos and articles.