diff --git a/about/index.rst b/about/index.rst new file mode 100644 index 000000000..efaa843e3 --- /dev/null +++ b/about/index.rst @@ -0,0 +1,12 @@ +About +===== + +.. toctree:: + :maxdepth: 1 + :name: toc-about + + faq + +.. history +.. authors +.. license diff --git a/classes/_classes.rst b/classes/index.rst similarity index 70% rename from classes/_classes.rst rename to classes/index.rst index 37aa66b25..fa23d6fa2 100644 --- a/classes/_classes.rst +++ b/classes/index.rst @@ -1,5 +1,5 @@ -Class reference -=============== +Godot API +========= .. toctree:: :maxdepth: 1 diff --git a/community/contributing/index.rst b/community/contributing/index.rst new file mode 100644 index 000000000..544a670f3 --- /dev/null +++ b/community/contributing/index.rst @@ -0,0 +1,10 @@ +Contributing +============ + +.. toctree:: + :maxdepth: 1 + :name: toc-community-contributing + + bug_triage_guidelines + doc_and_l10n_guidelines + updating_the_class_reference diff --git a/community/tutorials/3d/index.rst b/community/tutorials/3d/index.rst new file mode 100644 index 000000000..b9579bd5b --- /dev/null +++ b/community/tutorials/3d/index.rst @@ -0,0 +1,10 @@ +3D +== + +.. toctree:: + :maxdepth: 1 + :name: toc-community-tutorials-3d + + mesh_generation_with_heightmap_and_shaders + working_with_3d_skeletons + inverse_kinematics diff --git a/community/tutorials/index.rst b/community/tutorials/index.rst new file mode 100644 index 000000000..a4f259d77 --- /dev/null +++ b/community/tutorials/index.rst @@ -0,0 +1,10 @@ +Tutorials +========= + +.. toctree:: + :maxdepth: 1 + :name: toc-community-tutorials + + 3d/index + +.. external_resources diff --git a/development/compiling/index.rst b/development/compiling/index.rst new file mode 100644 index 000000000..ff57319a6 --- /dev/null +++ b/development/compiling/index.rst @@ -0,0 +1,18 @@ +Compiling +========= + +.. toctree:: + :maxdepth: 1 + :name: toc-devel-compiling + + introduction_to_the_buildsystem + compiling_for_windows + compiling_for_x11 + compiling_for_osx + compiling_for_android + compiling_for_ios + cross-compiling_for_ios_on_linux + compiling_for_uwp + compiling_for_web + batch_building_templates + packaging_godot diff --git a/development/cpp/index.rst b/development/cpp/index.rst new file mode 100644 index 000000000..dde855244 --- /dev/null +++ b/development/cpp/index.rst @@ -0,0 +1,15 @@ +Developing in C++ +================= + +.. toctree:: + :maxdepth: 1 + :name: toc-devel-cpp + + introduction_to_godot_development + configuring_an_ide + core_types + variant_class + object_class + inheritance_class_tree + custom_modules_in_cpp + creating_android_modules diff --git a/development/plugins/index.rst b/development/plugins/index.rst new file mode 100644 index 000000000..9b5cf6a47 --- /dev/null +++ b/development/plugins/index.rst @@ -0,0 +1,8 @@ +Editor plugins +============== + +.. toctree:: + :maxdepth: 1 + :name: toc-devel-plugins + + making_plugins diff --git a/index.rst b/index.rst index 7b357b269..647511a43 100644 --- a/index.rst +++ b/index.rst @@ -18,41 +18,60 @@ or annoy us at the #godotengine-devel IRC channel! The main documentation for the site is organized into a few sections: -* :ref:`sec-tutorials` -* :ref:`sec-reference` +* :ref:`sec-general` +* :ref:`sec-learn` +* :ref:`sec-devel` * :ref:`sec-community` +* :ref:`sec-class-ref` + +-------------- .. toctree:: :maxdepth: 1 - :caption: Tutorials - :name: sec-tutorials + :caption: General + :name: sec-general + + about/index - tutorials/step_by_step/_step_by_step - tutorials/engine/_engine - tutorials/2d/_2d - tutorials/3d/_3d - tutorials/_networking - tutorials/_plugins - tutorials/_misc_tutorials - tutorials/asset_pipeline/_asset_pipeline .. toctree:: :maxdepth: 1 - :caption: Reference - :name: sec-reference + :caption: Learning + :name: sec-learn + + learning/step_by_step/index + learning/editor/index + learning/features/index + learning/scripting/index + learning/workflow/index + + +.. toctree:: + :maxdepth: 1 + :caption: Development + :name: sec-devel + + development/plugins/index + development/compiling/index + development/cpp/index - classes/_classes - reference/_languages - reference/_cheat_sheets - reference/_compiling - reference/_advanced .. toctree:: :maxdepth: 1 :caption: Community :name: sec-community - contributing/_contributing + community/contributing/index + community/tutorials/index + + +.. toctree:: + :maxdepth: 1 + :caption: Class reference + :name: sec-class-ref + + classes/index + .. Indices and tables .. ------------------ diff --git a/learning/editor/index.rst b/learning/editor/index.rst new file mode 100644 index 000000000..e7e996c9f --- /dev/null +++ b/learning/editor/index.rst @@ -0,0 +1,13 @@ +Editor manual +============= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-editor + + 2d_and_3d_keybindings + unity_to_godot + command_line_tutorial + +.. ue4_to_godot +.. debugging diff --git a/learning/features/2d/index.rst b/learning/features/2d/index.rst new file mode 100644 index 000000000..4d7422816 --- /dev/null +++ b/learning/features/2d/index.rst @@ -0,0 +1,12 @@ +2D +== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-2d + + 2d_transforms + canvas_layers + using_tilemaps + custom_drawing_in_2d + particle_systems_2d diff --git a/learning/features/3d/index.rst b/learning/features/3d/index.rst new file mode 100644 index 000000000..c10ffa720 --- /dev/null +++ b/learning/features/3d/index.rst @@ -0,0 +1,15 @@ +3D +== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-3d + + introduction_to_3d + 3d_performance_and_limitations + importing_3d_meshes + importing_3d_scenes + materials + fixed_materials + high_dynamic_range + using_gridmaps diff --git a/learning/features/animation/index.rst b/learning/features/animation/index.rst new file mode 100644 index 000000000..01cf7e0ff --- /dev/null +++ b/learning/features/animation/index.rst @@ -0,0 +1,8 @@ +Animation +========= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-animation + + cutout_animation diff --git a/learning/features/gui/index.rst b/learning/features/gui/index.rst new file mode 100644 index 000000000..0fc0c8f81 --- /dev/null +++ b/learning/features/gui/index.rst @@ -0,0 +1,13 @@ +GUI +=== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-gui + + gui_skinning + custom_gui_controls + size_and_anchors + bbcode_in_richtextlabel + +.. gui_containers diff --git a/learning/features/index.rst b/learning/features/index.rst new file mode 100644 index 000000000..7a3208058 --- /dev/null +++ b/learning/features/index.rst @@ -0,0 +1,22 @@ +Engine features +=============== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features + + math/index + 2d/index + 3d/index + gui/index + physics/index + viewports/index + inputs/index + animation/index + lighting/index + shading/index + networking/index + platform/index + misc/index + +.. audio/index diff --git a/learning/features/inputs/index.rst b/learning/features/inputs/index.rst new file mode 100644 index 000000000..2df5163e9 --- /dev/null +++ b/learning/features/inputs/index.rst @@ -0,0 +1,9 @@ +Inputs +====== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-inputs + + inputevent + mouse_and_input_coordinates diff --git a/learning/features/lighting/index.rst b/learning/features/lighting/index.rst new file mode 100644 index 000000000..011b8c974 --- /dev/null +++ b/learning/features/lighting/index.rst @@ -0,0 +1,9 @@ +Lighting +======== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-lighting + + lighting + shadow_mapping diff --git a/learning/features/math/index.rst b/learning/features/math/index.rst new file mode 100644 index 000000000..5a9cc2589 --- /dev/null +++ b/learning/features/math/index.rst @@ -0,0 +1,9 @@ +Math +==== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-math + + vector_math + matrices_and_transforms diff --git a/learning/features/misc/index.rst b/learning/features/misc/index.rst new file mode 100644 index 000000000..d1ee7040d --- /dev/null +++ b/learning/features/misc/index.rst @@ -0,0 +1,16 @@ +Miscellaneous +============= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-misc + + background_loading + data_paths + saving_games + encrypting_save_games + handling_quit_requests + pausing_games + internationalizing_games + locales + binary_serialization_api diff --git a/learning/features/networking/index.rst b/learning/features/networking/index.rst new file mode 100644 index 000000000..9ca5fc243 --- /dev/null +++ b/learning/features/networking/index.rst @@ -0,0 +1,12 @@ +Networking +========== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-networking + + high_level_multiplayer + http_client_class + ssl_certificates + +.. managing_tcp_udp_connections.rst diff --git a/learning/features/physics/index.rst b/learning/features/physics/index.rst new file mode 100644 index 000000000..38eda2db1 --- /dev/null +++ b/learning/features/physics/index.rst @@ -0,0 +1,10 @@ +Physics +======= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-physics + + physics_introduction + ray-casting + kinematic_character_2d diff --git a/learning/features/platform/index.rst b/learning/features/platform/index.rst new file mode 100644 index 000000000..f0480b9c8 --- /dev/null +++ b/learning/features/platform/index.rst @@ -0,0 +1,9 @@ +Platform-specific +================= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-platform + + android_in_app_purchases + services_for_ios diff --git a/learning/features/shading/index.rst b/learning/features/shading/index.rst new file mode 100644 index 000000000..773b26e89 --- /dev/null +++ b/learning/features/shading/index.rst @@ -0,0 +1,10 @@ +Shading +======= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-shading + + shading_language + shader_materials + screen-reading_shaders diff --git a/learning/features/viewports/index.rst b/learning/features/viewports/index.rst new file mode 100644 index 000000000..bc78ead8c --- /dev/null +++ b/learning/features/viewports/index.rst @@ -0,0 +1,9 @@ +Viewports +========= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-features-viewports + + viewports + multiple_resolutions diff --git a/learning/scripting/gdscript/index.rst b/learning/scripting/gdscript/index.rst new file mode 100644 index 000000000..8d294feb5 --- /dev/null +++ b/learning/scripting/gdscript/index.rst @@ -0,0 +1,10 @@ +GDScript +======== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-scripting-gdscript + + gdscript_basics + gdscript_advanced + gdscript_format_string diff --git a/learning/scripting/index.rst b/learning/scripting/index.rst new file mode 100644 index 000000000..b549fce8d --- /dev/null +++ b/learning/scripting/index.rst @@ -0,0 +1,8 @@ +Scripting +========= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-scripting + + gdscript/index diff --git a/learning/getting_started/animations.rst b/learning/step_by_step/animations.rst similarity index 100% rename from learning/getting_started/animations.rst rename to learning/step_by_step/animations.rst diff --git a/learning/getting_started/filesystem.rst b/learning/step_by_step/filesystem.rst similarity index 100% rename from learning/getting_started/filesystem.rst rename to learning/step_by_step/filesystem.rst diff --git a/learning/getting_started/gui_tutorial.rst b/learning/step_by_step/gui_tutorial.rst similarity index 100% rename from learning/getting_started/gui_tutorial.rst rename to learning/step_by_step/gui_tutorial.rst diff --git a/learning/step_by_step/index.rst b/learning/step_by_step/index.rst new file mode 100644 index 000000000..a9bb13a53 --- /dev/null +++ b/learning/step_by_step/index.rst @@ -0,0 +1,20 @@ +Step by step +============ + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-step_by_step + + scenes_and_nodes + instancing + instancing_continued + scripting + scripting_continued + simple_2d_game + gui_tutorial + splash_screen + animations + resources + filesystem + scene_tree + singletons_autoload diff --git a/learning/getting_started/instancing.rst b/learning/step_by_step/instancing.rst similarity index 100% rename from learning/getting_started/instancing.rst rename to learning/step_by_step/instancing.rst diff --git a/learning/getting_started/instancing_continued.rst b/learning/step_by_step/instancing_continued.rst similarity index 100% rename from learning/getting_started/instancing_continued.rst rename to learning/step_by_step/instancing_continued.rst diff --git a/learning/getting_started/resources.rst b/learning/step_by_step/resources.rst similarity index 100% rename from learning/getting_started/resources.rst rename to learning/step_by_step/resources.rst diff --git a/learning/getting_started/scene_tree.rst b/learning/step_by_step/scene_tree.rst similarity index 100% rename from learning/getting_started/scene_tree.rst rename to learning/step_by_step/scene_tree.rst diff --git a/learning/getting_started/scenes_and_nodes.rst b/learning/step_by_step/scenes_and_nodes.rst similarity index 100% rename from learning/getting_started/scenes_and_nodes.rst rename to learning/step_by_step/scenes_and_nodes.rst diff --git a/learning/getting_started/scripting.rst b/learning/step_by_step/scripting.rst similarity index 100% rename from learning/getting_started/scripting.rst rename to learning/step_by_step/scripting.rst diff --git a/learning/getting_started/scripting_continued.rst b/learning/step_by_step/scripting_continued.rst similarity index 100% rename from learning/getting_started/scripting_continued.rst rename to learning/step_by_step/scripting_continued.rst diff --git a/learning/getting_started/simple_2d_game.rst b/learning/step_by_step/simple_2d_game.rst similarity index 100% rename from learning/getting_started/simple_2d_game.rst rename to learning/step_by_step/simple_2d_game.rst diff --git a/learning/getting_started/singletons_autoload.rst b/learning/step_by_step/singletons_autoload.rst similarity index 100% rename from learning/getting_started/singletons_autoload.rst rename to learning/step_by_step/singletons_autoload.rst diff --git a/learning/getting_started/splash_screen.rst b/learning/step_by_step/splash_screen.rst similarity index 100% rename from learning/getting_started/splash_screen.rst rename to learning/step_by_step/splash_screen.rst diff --git a/learning/workflow/assets/index.rst b/learning/workflow/assets/index.rst new file mode 100644 index 000000000..dac630988 --- /dev/null +++ b/learning/workflow/assets/index.rst @@ -0,0 +1,14 @@ +Assets workflow +=============== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-workflow-assets + + import_process + managing_image_files + importing_textures + importing_audio_samples + importing_fonts + importing_translations + exporting_images diff --git a/learning/workflow/export/index.rst b/learning/workflow/export/index.rst new file mode 100644 index 000000000..5d974a94b --- /dev/null +++ b/learning/workflow/export/index.rst @@ -0,0 +1,14 @@ +Export +====== + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-workflow-export + + exporting_projects + exporting_for_pc + exporting_for_ios + exporting_for_uwp + exporting_for_android + exporting_for_web + one-click_deploy diff --git a/learning/workflow/index.rst b/learning/workflow/index.rst new file mode 100644 index 000000000..d6414d0c5 --- /dev/null +++ b/learning/workflow/index.rst @@ -0,0 +1,10 @@ +Project workflow +================ + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-workflow + + project_setup/index + assets/index + export/index diff --git a/learning/workflow/project_setup/index.rst b/learning/workflow/project_setup/index.rst new file mode 100644 index 000000000..38f3d698d --- /dev/null +++ b/learning/workflow/project_setup/index.rst @@ -0,0 +1,11 @@ +Project setup +============= + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-workflow-project_setup + + project_organization + +.. plugins_from_assetlib +.. cvs