Possibilité de spécifier le port sur lequel servir la doc produite (#1810)

christopheNan · web-flow · commit d3dc3685b4e3 · 2022-02-06T15:45:57.000+01:00
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -174,9 +174,16 @@ documentation local&nbsp;:
     make serve
 
 
-La documentation est publi&eacute;e l'adresse `<http://localhost:8000/library/sys.html>`_
-(ou tout autre port indiqu&eacute; par la sortie de la commande pr&eacute;c&eacute;dente). Vous pouvez
-recommencer les &eacute;tapes de cette section autant de fois que n&eacute;cessaire.
+La documentation est publi&eacute;e l'adresse `<http://localhost:8000/library/sys.html>`_.
+Si vous souhaitez modifier le port de ce serveur (par exemple 8080), utilisez&nbsp;:
+
+.. code-block:: bash
+
+    make serve SERVE_PORT=8080
+
+
+Vous pouvez recommencer les &eacute;tapes de cette section autant de fois que
+n&eacute;cessaire.
 
 Poedit donne beaucoup d'avertissements, par exemple pour vous informer que
 &laquo; la traduction devrait commencer par une majuscule &raquo; car c'est le cas pour
diff --git a/Makefile b/Makefile
@@ -44,6 +44,7 @@ PYTHON := $(shell which python3)
 MODE := html
 POSPELL_TMP_DIR := .pospell/
 JOBS := auto
+SERVE_PORT :=
 
 # Detect OS
 
@@ -98,7 +99,11 @@ ensure_prerequisites: venv/cpython/.git/HEAD
 
 .PHONY: serve
 serve:
+ifdef SERVE_PORT
+	$(MAKE) -C venv/cpython/Doc/ serve SERVE_PORT=$(SERVE_PORT)
+else
 	$(MAKE) -C venv/cpython/Doc/ serve
+endif
 
 .PHONY: todo
 todo: ensure_prerequisites

-Original file line number
+Diff line change
     make serve
 -La documentation est publiée l'adresse `<http://localhost:8000/library/sys.html>`_
 -(ou tout autre port indiqué par la sortie de la commande précédente). Vous pouvez
 -recommencer les étapes de cette section autant de fois que nécessaire.
 +La documentation est publiée l'adresse `<http://localhost:8000/library/sys.html>`_.
 +Si vous souhaitez modifier le port de ce serveur (par exemple 8080), utilisez :
++
 +.. code-block:: bash
++
 +    make serve SERVE_PORT=8080
++
++
 +Vous pouvez recommencer les étapes de cette section autant de fois que
 +nécessaire.
 Poedit donne beaucoup d'avertissements, par exemple pour vous informer que
 « la traduction devrait commencer par une majuscule » car c'est le cas pour