Tutorials section dynamic adds pages and creates sections through glo…

…bbing
vala-lang · May 3, 2024 · d224ac1 · d224ac1
1 parent c4f3a47
commit d224ac1
Show file tree

Hide file tree

Showing 60 changed files with 24 additions and 17 deletions.
diff --git a/source/tutorials/gui-programming.rst b/source/tutorials/gui-programming.rst
@@ -0,0 +1,10 @@
+GUI Programming
+===============
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   gui-programming/*
+   GNOME Developer Documenation - Tutorials <https://developer.gnome.org/documentation/tutorials.html>
+   elementary OS - Writing Apps <https://docs.elementary.io/develop/writing-apps/the-basic-setup>
diff --git a/source/tutorials/index.rst b/source/tutorials/index.rst
@@ -2,18 +2,7 @@ Tutorials
 ==========
 
 .. toctree::
-   :hidden:
+   :maxdepth: 2
+   :glob:
 
-   main/index
-
-
-Programming Language
---------------------
-
-- `Vala Main Tutorial <main>`_
-
-GUI Programming
----------------
-
-- `GNOME Developer Documenation - Tutorials <https://developer.gnome.org/documentation/tutorials.html>`_
-- `elementary OS - Writing Apps <https://docs.elementary.io/develop/writing-apps/the-basic-setup>`_
+   *
diff --git a/source/tutorials/programming-language.rst b/source/tutorials/programming-language.rst
@@ -0,0 +1,8 @@
+Programming Language
+====================
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   programming-language/*
diff --git a/source/tutorials/main/index.rst → ...e/tutorials/programming-language/main.rst b/source/tutorials/main/index.rst → ...e/tutorials/programming-language/main.rst
@@ -45,4 +45,4 @@ At some point I will add in references to the Vala documentation, but that isn't
    :maxdepth: 1
    :glob:
 
-   *
+   main/*
diff --git a/...ce/tutorials/main/01-00-first-program.rst → ...ing-language/main/01-00-first-program.rst b/...ce/tutorials/main/01-00-first-program.rst → ...ing-language/main/01-00-first-program.rst
@@ -64,5 +64,5 @@ Assuming you have Vala installed, then all it takes to compile and execute this
 
 *valac* is the Vala compiler, which will compile your Vala code into a binary.  The resulting binary will have the same name as the source file and can then be directly executed on the machine. You can probably guess the output.
 
-If you get some warnings from a C language compiler, please jump to :doc:`/tutorials/main/07-00-tools/07-01-valac` for the reason and solution.
+If you get some warnings from a C language compiler, please jump to :doc:`07-00-tools/07-01-valac` for the reason and solution.
 
diff --git a/source/tutorials/main/02-00-basics.rst → ...rogramming-language/main/02-00-basics.rst b/source/tutorials/main/02-00-basics.rst → ...rogramming-language/main/02-00-basics.rst
diff --git a/...cs/02-01-source-files-and-compilation.rst → ...cs/02-01-source-files-and-compilation.rst b/...cs/02-01-source-files-and-compilation.rst → ...cs/02-01-source-files-and-compilation.rst
diff --git a/...in/02-00-basics/02-02-syntax-overview.rst → ...in/02-00-basics/02-02-syntax-overview.rst b/...in/02-00-basics/02-02-syntax-overview.rst → ...in/02-00-basics/02-02-syntax-overview.rst
diff --git a/...ials/main/02-00-basics/02-03-comments.rst → ...uage/main/02-00-basics/02-03-comments.rst b/...ials/main/02-00-basics/02-03-comments.rst → ...uage/main/02-00-basics/02-03-comments.rst
diff --git a/...ls/main/02-00-basics/02-04-data-types.rst → ...ge/main/02-00-basics/02-04-data-types.rst b/...ls/main/02-00-basics/02-04-data-types.rst → ...ge/main/02-00-basics/02-04-data-types.rst
diff --git a/...als/main/02-00-basics/02-05-operators.rst → ...age/main/02-00-basics/02-05-operators.rst b/...als/main/02-00-basics/02-05-operators.rst → ...age/main/02-00-basics/02-05-operators.rst
diff --git a/...02-00-basics/02-06-control-structures.rst → ...02-00-basics/02-06-control-structures.rst b/...02-00-basics/02-06-control-structures.rst → ...02-00-basics/02-06-control-structures.rst
diff --git a/.../02-00-basics/02-07-language-elements.rst → .../02-00-basics/02-07-language-elements.rst b/.../02-00-basics/02-07-language-elements.rst → .../02-00-basics/02-07-language-elements.rst
diff --git a/...in/02-00-basics/02-08-code-attributes.rst → ...in/02-00-basics/02-08-code-attributes.rst b/...in/02-00-basics/02-08-code-attributes.rst → ...in/02-00-basics/02-08-code-attributes.rst
diff --git a/...ain/03-00-object-oriented-programming.rst → ...ain/03-00-object-oriented-programming.rst b/...ain/03-00-object-oriented-programming.rst → ...ain/03-00-object-oriented-programming.rst
diff --git a/...ect-oriented-programming/03-01-basics.rst → ...ect-oriented-programming/03-01-basics.rst b/...ect-oriented-programming/03-01-basics.rst → ...ect-oriented-programming/03-01-basics.rst
diff --git a/...iented-programming/03-02-construction.rst → ...iented-programming/03-02-construction.rst b/...iented-programming/03-02-construction.rst → ...iented-programming/03-02-construction.rst
diff --git a/...riented-programming/03-03-destruction.rst → ...riented-programming/03-03-destruction.rst b/...riented-programming/03-03-destruction.rst → ...riented-programming/03-03-destruction.rst
diff --git a/...ct-oriented-programming/03-04-signals.rst → ...ct-oriented-programming/03-04-signals.rst b/...ct-oriented-programming/03-04-signals.rst → ...ct-oriented-programming/03-04-signals.rst
diff --git a/...oriented-programming/03-05-properties.rst → ...oriented-programming/03-05-properties.rst b/...oriented-programming/03-05-properties.rst → ...oriented-programming/03-05-properties.rst
diff --git a/...riented-programming/03-06-inheritance.rst → ...riented-programming/03-06-inheritance.rst b/...riented-programming/03-06-inheritance.rst → ...riented-programming/03-06-inheritance.rst
diff --git a/...ed-programming/03-07-abstract-classes.rst → ...ed-programming/03-07-abstract-classes.rst b/...ed-programming/03-07-abstract-classes.rst → ...ed-programming/03-07-abstract-classes.rst
diff --git a/...oriented-programming/03-08-interfaces.rst → ...oriented-programming/03-08-interfaces.rst b/...oriented-programming/03-08-interfaces.rst → ...oriented-programming/03-08-interfaces.rst
diff --git a/...iented-programming/03-09-polymorphism.rst → ...iented-programming/03-09-polymorphism.rst b/...iented-programming/03-09-polymorphism.rst → ...iented-programming/03-09-polymorphism.rst
diff --git a/...ented-programming/03-10-method-hiding.rst → ...ented-programming/03-10-method-hiding.rst b/...ented-programming/03-10-method-hiding.rst → ...ented-programming/03-10-method-hiding.rst
diff --git a/...mming/03-11-run-time-type-information.rst → ...mming/03-11-run-time-type-information.rst b/...mming/03-11-run-time-type-information.rst → ...mming/03-11-run-time-type-information.rst
diff --git a/...rogramming/03-12-dynamic-type-casting.rst → ...rogramming/03-12-dynamic-type-casting.rst b/...rogramming/03-12-dynamic-type-casting.rst → ...rogramming/03-12-dynamic-type-casting.rst
diff --git a/...t-oriented-programming/03-13-generics.rst → ...t-oriented-programming/03-13-generics.rst b/...t-oriented-programming/03-13-generics.rst → ...t-oriented-programming/03-13-generics.rst
diff --git a/...ming/03-14-gobject-style-construction.rst → ...ming/03-14-gobject-style-construction.rst b/...ming/03-14-gobject-style-construction.rst → ...ming/03-14-gobject-style-construction.rst
diff --git a/...utorials/main/04-00-advanced-features.rst → ...language/main/04-00-advanced-features.rst b/...utorials/main/04-00-advanced-features.rst → ...language/main/04-00-advanced-features.rst
diff --git a/...1-assertions-and-contract-programming.rst → ...1-assertions-and-contract-programming.rst b/...1-assertions-and-contract-programming.rst → ...1-assertions-and-contract-programming.rst
diff --git a/...dvanced-features/04-02-error-handling.rst → ...dvanced-features/04-02-error-handling.rst b/...dvanced-features/04-02-error-handling.rst → ...dvanced-features/04-02-error-handling.rst
diff --git a/...d-features/04-03-parameter-directions.rst → ...d-features/04-03-parameter-directions.rst b/...d-features/04-03-parameter-directions.rst → ...d-features/04-03-parameter-directions.rst
diff --git a/...0-advanced-features/04-04-collections.rst → ...0-advanced-features/04-04-collections.rst b/...0-advanced-features/04-04-collections.rst → ...0-advanced-features/04-04-collections.rst
diff --git a/...res/04-05-methods-with-syntax-support.rst → ...res/04-05-methods-with-syntax-support.rst b/...res/04-05-methods-with-syntax-support.rst → ...res/04-05-methods-with-syntax-support.rst
diff --git a/...vanced-features/04-06-multi-threading.rst → ...vanced-features/04-06-multi-threading.rst b/...vanced-features/04-06-multi-threading.rst → ...vanced-features/04-06-multi-threading.rst
diff --git a/...advanced-features/04-07-the-main-loop.rst → ...advanced-features/04-07-the-main-loop.rst b/...advanced-features/04-07-the-main-loop.rst → ...advanced-features/04-07-the-main-loop.rst
diff --git a/...d-features/04-08-asynchronous-methods.rst → ...d-features/04-08-asynchronous-methods.rst b/...d-features/04-08-asynchronous-methods.rst → ...d-features/04-08-asynchronous-methods.rst
diff --git a/...vanced-features/04-09-weak-references.rst → ...vanced-features/04-09-weak-references.rst b/...vanced-features/04-09-weak-references.rst → ...vanced-features/04-09-weak-references.rst
diff --git a/...-00-advanced-features/04-10-ownership.rst → ...-00-advanced-features/04-10-ownership.rst b/...-00-advanced-features/04-10-ownership.rst → ...-00-advanced-features/04-10-ownership.rst
diff --git a/.../04-11-variable-length-argument-lists.rst → .../04-11-variable-length-argument-lists.rst b/.../04-11-variable-length-argument-lists.rst → .../04-11-variable-length-argument-lists.rst
diff --git a/...4-00-advanced-features/04-12-pointers.rst → ...4-00-advanced-features/04-12-pointers.rst b/...4-00-advanced-features/04-12-pointers.rst → ...4-00-advanced-features/04-12-pointers.rst
diff --git a/...ced-features/04-13-non-object-classes.rst → ...ced-features/04-13-non-object-classes.rst b/...ced-features/04-13-non-object-classes.rst → ...ced-features/04-13-non-object-classes.rst
diff --git a/...nced-features/04-14-d-bus-integration.rst → ...nced-features/04-14-d-bus-integration.rst b/...nced-features/04-14-d-bus-integration.rst → ...nced-features/04-14-d-bus-integration.rst
diff --git a/...4-00-advanced-features/04-15-profiles.rst → ...4-00-advanced-features/04-15-profiles.rst b/...4-00-advanced-features/04-15-profiles.rst → ...4-00-advanced-features/04-15-profiles.rst
diff --git a/...ials/main/05-00-experimental-features.rst → ...uage/main/05-00-experimental-features.rst b/...ials/main/05-00-experimental-features.rst → ...uage/main/05-00-experimental-features.rst
diff --git a/.../05-01-chained-relational-expressions.rst → .../05-01-chained-relational-expressions.rst b/.../05-01-chained-relational-expressions.rst → .../05-01-chained-relational-expressions.rst
diff --git a/...res/05-02-regular-expression-literals.rst → ...res/05-02-regular-expression-literals.rst b/...res/05-02-regular-expression-literals.rst → ...res/05-02-regular-expression-literals.rst
diff --git a/...l-features/05-03-strict-non-null-mode.rst → ...l-features/05-03-strict-non-null-mode.rst b/...l-features/05-03-strict-non-null-mode.rst → ...l-features/05-03-strict-non-null-mode.rst
diff --git a/source/tutorials/main/06-00-libraries.rst → ...ramming-language/main/06-00-libraries.rst b/source/tutorials/main/06-00-libraries.rst → ...ramming-language/main/06-00-libraries.rst
diff --git a/...06-00-libraries/06-01-using-libraries.rst → ...06-00-libraries/06-01-using-libraries.rst b/...06-00-libraries/06-01-using-libraries.rst → ...06-00-libraries/06-01-using-libraries.rst
diff --git a/...00-libraries/06-02-creating-a-library.rst → ...00-libraries/06-02-creating-a-library.rst b/...00-libraries/06-02-creating-a-library.rst → ...00-libraries/06-02-creating-a-library.rst
diff --git a/...-03-binding-libraries-with-vapi-files.rst → ...-03-binding-libraries-with-vapi-files.rst b/...-03-binding-libraries-with-vapi-files.rst → ...-03-binding-libraries-with-vapi-files.rst
diff --git a/source/tutorials/main/07-00-tools.rst → ...programming-language/main/07-00-tools.rst b/source/tutorials/main/07-00-tools.rst → ...programming-language/main/07-00-tools.rst
diff --git a/...utorials/main/07-00-tools/07-01-valac.rst → ...language/main/07-00-tools/07-01-valac.rst b/...utorials/main/07-00-tools/07-01-valac.rst → ...language/main/07-00-tools/07-01-valac.rst
@@ -8,7 +8,7 @@ Vala has better information than the C compiler, so it knows certain things are
 
 Unfortunately we can't just add casts everywhere since there are situations where we can't generate a valid cast (and, what's more, no way to know what those situations are).
 
-For example, compiling the :doc:`Hello World program </tutorials/main/01-00-first-program>` will give us some warnings because ``valac`` by default generates code which is compatible with older versions of the ``GLib``.Some methods may have been deprecated in your new version of GLib so that C language compiler will warn you.
+For example, compiling the :doc:`Hello World program </../01-00-first-program>` will give us some warnings because ``valac`` by default generates code which is compatible with older versions of the ``GLib``.Some methods may have been deprecated in your new version of GLib so that C language compiler will warn you.
 
 Imagine a machine with older glib version want to run your vala program!
 

diff --git a/...orials/main/07-00-tools/07-02-vapigen.rst → ...nguage/main/07-00-tools/07-02-vapigen.rst b/...orials/main/07-00-tools/07-02-vapigen.rst → ...nguage/main/07-00-tools/07-02-vapigen.rst
diff --git a/...07-00-tools/07-03-vala-gen-introspect.rst → ...07-00-tools/07-03-vala-gen-introspect.rst b/...07-00-tools/07-03-vala-gen-introspect.rst → ...07-00-tools/07-03-vala-gen-introspect.rst
diff --git a/source/tutorials/main/08-00-techniques.rst → ...amming-language/main/08-00-techniques.rst b/source/tutorials/main/08-00-techniques.rst → ...amming-language/main/08-00-techniques.rst
diff --git a/...main/08-00-techniques/08-01-debugging.rst → ...main/08-00-techniques/08-01-debugging.rst b/...main/08-00-techniques/08-01-debugging.rst → ...main/08-00-techniques/08-01-debugging.rst
diff --git a/...ain/08-00-techniques/08-02-using-glib.rst → ...ain/08-00-techniques/08-02-using-glib.rst b/...ain/08-00-techniques/08-02-using-glib.rst → ...ain/08-00-techniques/08-02-using-glib.rst
-Original file line number
+Diff line change
@@ Expand Up @@
        :maxdepth: 1
        :glob:
-       *
+       main/*
Original file line number	Diff line number	Diff line change
Expand Up		@@ -64,5 +64,5 @@ Assuming you have Vala installed, then all it takes to compile and execute this

		valac is the Vala compiler, which will compile your Vala code into a binary. The resulting binary will have the same name as the source file and can then be directly executed on the machine. You can probably guess the output.

		If you get some warnings from a C language compiler, please jump to :doc:`/tutorials/main/07-00-tools/07-01-valac` for the reason and solution.
		If you get some warnings from a C language compiler, please jump to :doc:`07-00-tools/07-01-valac` for the reason and solution.