rougail/docs/tutorial/index.rst

36 lines
1 KiB
ReStructuredText
Raw Normal View History

2024-10-14 14:05:23 +02:00
Tutorial with a real world sample
=====================================
Here's the demo. We're gonna start with a use case that comes from the real world.
.. demo:: Demo: configuring (the setting of) your favorite web browser
This tutorial will show you an example of Rougail use based on the
"how to set a proxy" in the `Mozilla Firefox <https://www.mozilla.org/en-US/firefox/new/>`_ browser
use case.
More precisely, this tutorial aims at reproducing this Mozilla Firefox settings page:
.. note:: We are not coding a firefox plugin here.
We are just going to handle some of the firefox configuration settings
with Rougail.
Presentation of the firefox configuration variables
-----------------------------------------------------------
Let's dive into the configuration validation use case,
that is the values entered by the user that have to be validated.
At first glance we have a choice between five variables:
.. image:: images/firefox_01.png
.. toctree::
:titlesonly:
:caption: The firefox tutorial steps
tutorial