New documentation for websites contributions (#82)

* New documentation for websites contributions

Fix #67 and #FreeCAD/FreeCAD-Homepage/issues/135

Adds a new section under Technical for documentation about FreeCAD websites ecosystem for interested contributors.
First commit with base structure only.
Expect following commits with more content and screenshots.

* Add more content and update images

* Add more content, fix typo and hide TODO in comments

* Fix commands

Author: marcuspollio

technical/DevBook.md

@@ -0,0 +1,27 @@
+---
+layout: default
+---
+
+# Contributing to the Developer Handbook
+
+Technical information for contributors interested to work on Developer Handbook.
+
+<!-- ## Structure TODO: add more content later -->
+
+## Running locally
+
+To run the Developer Handbook locally, Jekyll, the Ruby static site generator, must be executed on the corresponding folder.\
+On a Debian or Ubuntu GNU/Linux system, Bundler is used :
+
+```
+$ sudo apt install ruby-bundler ruby-dev build-essential
+$ bundle install
+$ cd path/to/your/local/fork/of/the/devhandbook
+$ bundle exec jekyll serve
+```
+
+Open then the link to `127.0.0.1:4000` (or `localhost:4000`) in you web browser.
+
+<!-- ## Design guidelines TODO: add more content later -->
+
+<!-- ## Ressources TODO: add more content later -->

technical/FPAweb.md

@@ -0,0 +1,27 @@
+---
+layout: default
+---
+
+# Contributing to the FreeCAD Project Association website
+
+Technical information for contributors interested to work on FreeCAD Project Association website.
+
+<!-- ## Structure TODO: add more content later -->
+
+## Running locally
+
+To run the FPA website locally, Jekyll, the Ruby static site generator, must be executed on the corresponding folder.\
+On a Debian or Ubuntu GNU/Linux system, Bundler is used :
+
+```
+$ sudo apt install ruby-bundler ruby-dev build-essential
+$ bundle install
+$ cd path/to/your/local/fork/of/the/FPA/website
+$ bundle exec jekyll serve
+```
+
+Open then the link to `127.0.0.1:4000` (or `localhost:4000`) in you web browser.
+
+<!-- ## Design guidelines TODO: add more content later -->
+
+<!-- ## Ressources TODO: add more content later -->

technical/FreeCADweb.md

@@ -0,0 +1,55 @@
+---
+layout: default
+---
+
+# Contributing to the FreeCAD main website
+
+Technical information for contributors interested to work on FreeCAD main website.
+
+<!-- ## Structure TODO: add more content later -->
+
+## Running locally
+
+During development and before committing your changes, you may want to display the website in your web browser locally, without installing a full web server solution stack like XAMPP.\
+You can instead just transcribe the PHP files into HTML that your web broswer can read.
+
+1) To do so, fork the original FreeCAD-Homepage repository to your personal GitHub account :
+
+![Fork the repository](./resources/FreeCADweb_01.jpg)
+
+2) If you don't have an account or prefer to inspect and modify files locally without relying on GitHub's features, download the compressed folder and unzipp it :
+
+![Download the repository](./resources/FreeCADweb_02.jpg)
+
+3) From GitHub Desktop app, clone the fork you just created (skip this step if you downloaded the zip in step 2) :
+
+![Clone the fork](./resources/FreeCADweb_03.jpg)
+
+4) Make sure PHP is installed on your system (on GNU/Linux in 2023, install the PHP8 CLI package).
+
+5) Go to your local cloned copy of the repository, in the folder you specified previously ("FreeCAD-Homepage" in this case), and open the terminal at working-directory location :
+
+![Open Terminal in cloned local repo](./resources/FreeCADweb_05.jpg)
+
+6) Paste `php -S 127.0.0.1:8000` (or `php -S localhost:8000`) to start the PHP server locally:
+
+![Start PHP server](./resources/FreeCADweb_06.jpg)
+
+7) Open a new tab in your web browser with `127.0.0.1:8000` (or `localhost:8000`) to display the "index.php" file of the web page correctly.\
+If you want to reach a particular file, use `localhost:8000/MyFile.php`.
+
+![Start PHP server](./resources/FreeCADweb_07.jpg)
+
+N.B: the translation of the web pages does not work.
+
+<!-- ## Design guidelines TODO: add more content later -->
+
+## Managing translations
+
+In order for the language and translation management system to work, each text that potentially needs to be translated must be encapsulated as follows:
+
+`<?php echo _('Text_to_be_translated'); ?>`
+
+The site administrators regularly run a script that updates the translatable strings on the Crowdin platform. The added texts can then be translated by contributors. The newly translated content is then forwarded back to the website.
+
+<!-- ## Ressources TODO: add more content later -->

technical/SourceTreeBasics.md

@@ -10,7 +10,7 @@ A picture of the most commonly encountered branches of the tree.
 The full FreeCAD source tree has many other branches, but most Contributors will
 only need to deal with these:
 
-![The FreeCAD Source Tree](./SourceTreeBasics.svg)
+![The FreeCAD Source Tree](./resources/SourceTreeBasics.svg)
 
 ```mermaid
 graph LR

technical/TheApplicationModule.md

@@ -12,4 +12,4 @@ Application Modules provide specialized functions and may store specialized data
 
 Application Modules are almost always divided into two parts: App which manages the relevant document objects and operations on them, and Gui which handles the display.
 
-![Overview of an Application Module](./TheApplicationModule.svg)
+![Overview of an Application Module](./resources/TheApplicationModule.svg)

technical/Websites.md

@@ -0,0 +1,65 @@
+---
+layout: default
+---
+
+# Contributing to FreeCAD websites
+
+Technical information for contributors interested to work on FreeCAD websites.
+
+## The Ecosystem
+
+Currently, the websites infrastructure of FreeCAD consists of the following :
+
+- [The FreeCAD website](https://www.freecad.org) acts as the main entry point into FreeCAD's universe for all users, contributors and interested parties.
+
+- [The News Blog](https://blog.freecad.org/) brings together development news, tutorials and use cases from the community.
+
+- [The Wiki](https://wiki.freecad.org/) gathers all the documentation about FreeCAD, from usage to installation, development, release notes and much more. Historically, this has been the all-purpose place for all FreeCAD-related matters. A more development-oriented portion of it has been migrated to this Developer Handbook.
+
+- [The Developer Handbook](https://freecad.github.io/DevelopersHandbook/) is the very site you are currently in.
+
+- [The Forum](https://forum.freecad.org/) is one of the many places where the community meets and exchanges.
+
+- [The FreeCAD Project Association website](https://fpa.freecad.org/) groups everything that relates to the association overseeing the FreeCAD project.
+
+In addition to the implemented websites listed above, several external platforms are used :
+
+- [The Repositories](https://github.com/FreeCAD) of FreeCAD main codebase, building and packaging, continuous integration, addons, macros, library, websites and more are on GitHub.
+
+- [The Translations](https://crowdin.com/project/freecad) of the software interface and the main website are on Crowdin.
+
+Moreover, here are the current implementation initiatives not yet used :
+
+- [The FreeCAD Documentation](https://freecad-documentation.netlify.app/) overhaul as part of the GSOC 2023
+
+## Technical details
+
+### FreeCAD website
+
+The website mainly uses HTML/PHP, CSS, the Bootstrap and jQuery JavaScript libraries, the Font Awesome toolkit.\
+To contribute to the main website, find [here a few advices and ressources](./FreeCADweb.md).
+
+### News Blog
+
+The News Blog is based on WordPress.\
+<!-- To contribute to the blog, find here a few advices and ressources. TODO: contact Chennes, ConcreteDog and Alex -->
+
+### Wiki
+
+The News Blog is based on MediaWiki.\
+<!-- To contribute to the wiki, find here a few advices and ressources. TODO: contact wiki team -->
+
+### Developer Handbook
+
+The Developer Handbook uses Jekyll, a Ruby static site generator, and Markdown.\
+To contribute to the Developer Handbook, find [here a few advices and ressources](./DevBook.md).
+
+### Forum
+
+The News Blog is based on phpBB.\
+<!-- To contribute to the Forum, find here a few advices and ressources. TODO: contact forum team -->
+
+### FreeCAD Project Association website
+
+The FreeCAD Project Association website also uses Jekyll, a Ruby static site generator, and Markdown.\
+To contribute to the FreeCAD Project Association website, find [here a few advices and ressources](./FPAweb.md).

technical/index.md

@@ -9,42 +9,64 @@ Technical information of interest to Contributors.
 ## The Basics
 
 - [Developer's Glossary](./developerglossary.md)
+
 - [Source Tree Basics](./SourceTreeBasics.md)
+
 - [The Application Module](./TheApplicationModule.md)
+
 - [The Source Code in More Depth](https://wiki.freecad.org/The_FreeCAD_source_code)
+
 - [Writing Code for Translation](./translation.md)
+
 - [Automated Testing](./automated_testing.md)
+
 - [Dealing with Property Changes](./PropertyChanges.md)
+
 - The FreeCAD developer's tool set:
+
     - C++ and Python
     - [Qt](https://www.qt.io/): a cross platform development framework
     - [OpenCascade](https://www.opencascade.com/open-cascade-technology/): a geometry library
     - [Coin3d](https://www.coin3d.org/): a [scenegraph](https://wiki.freecad.org/Scenegraph) manager based on OpenInventor that handles drawing in the 3d window.
     - [Pivy](https://wiki.freecad.org/Pivy): a Python binding for Coin3d
 
+- [Contributing to FreeCAD websites](./Websites.md)
+
 ## Modifying FreeCAD
 
 - Contributing to FreeCAD
+
     - The process for submitting changes to FreeCAD is described in the [CONTRIBUTING.md](https://github.com/FreeCAD/FreeCAD/blob/master/CONTRIBUTING.md)
     file in the root of the source tree.
+
 - [Creating a WorkBench](https://wiki.freecad.org/Workbench_creation)
+
 - The [PowerUser's hub](https://wiki.freecad.org/Power_users_hub) in the FreeCAD wiki contains good information about Python scripting and workbench creation
+
 - [Accessing User Preferences](./preferences.md)
+
 - [Controlling Object Deletion](./ObjectDeletion.md)
+
 - [Create a Python Binding for C++ Class](./CreatePythonBindingForCpp.md)
+
 - [Checklist for Adding a Feature to a Workbench in C++](./ChecklistForNewFeatureC++.md)
 
 ## Release Management
 
 - [Overview](./ReleaseProcess.md)
+
     - [Major Releases](./MajorRelease.md)
     - [Minor Releases](./MinorRelease.md)
     - [Building Release Packages](./ReleasePackages.md)
 
 ## See Also
 
 - [Wiki Developer Hub](https://wiki.freecad.org/Developer_hub)
+
 - [Compiling](https://wiki.freecad.org/Developer_hub#Compiling_FreeCAD)
+
 - [Useful Python Modules](https://wiki.freecad.org/Extra_python_modules)
+
 - [OpenCascade Tutorials](http://opencascade.wikidot.com/romansarticles)
+
 - [Scripted Objects](https://wiki.freecad.org/Scripted_objects)