Skip to content

Commit 646a68a

Browse files
CalinouCalinou
committed
Redesign homepage into a landing page for various user profiles
The landing page was simplified and now points to several home pages.
1 parent 4442292 commit 646a68a

File tree

5 files changed

+207
-3
lines changed

5 files changed

+207
-3
lines changed

‎about/introduction.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Before you start
2222

2323
The :ref:`Tutorials and resources <doc_community_tutorials>` page lists
2424
video tutorials contributed by the community. If you prefer video to text,
25-
consider checking them out. Otherwise, :ref:`Getting Started <sec-learn>`
25+
consider checking them out. Otherwise, :ref:`doc_your_first_2d_game`
2626
is a great starting point.
2727

2828
In case you have trouble with one of the tutorials or your project,

‎contributing/index.rst‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
Thanks for your interest in contributing in Godot!
2+
3+
Not sure how you could help the Godot project? See :ref:`doc_ways_to_contribute`
4+
which lists several methods in which you can help improve Godot. You don't need
5+
programming experience to contribute to Godot, as there are several ways to
6+
improve the engine that do not involve programming.
7+
8+
These pages contain information about contributing to the engine's codebase and
9+
documentation:
10+
11+
.. toctree::
12+
:maxdepth: 1
13+
:name: toc-devel-contributing
14+
15+
workflow/index
16+
development/index
17+
documentation/index

‎index.rst‎

Lines changed: 53 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,59 @@ to this documentation, we recommend that you read the
2929
:ref:`introduction page <doc_about_intro>` to get an overview of what this
3030
documentation has to offer.
3131

32-
The table of contents in the sidebar should let you easily access the documentation
33-
for your topic of interest. You can also use the search function in the top-left corner.
32+
**To begin reading the relevant documentation, select the tile that matches your profile:**
33+
34+
.. raw:: html
35+
36+
<style>
37+
.grid-container {
38+
display: grid;
39+
grid-template-columns: 1fr 1fr;
40+
grid-template-rows: 1fr 1fr;
41+
gap: 0.375rem;
42+
grid-auto-flow: row;
43+
grid-template-areas:
44+
"new-to-game know-game-learn-godot"
45+
"know-godot-learn-godot contribute-to-godot";
46+
}
47+
48+
.grid-item {
49+
color: hsla(0, 0%, 100%, 0.9);
50+
padding: 1rem;
51+
border-radius: 0.375rem;
52+
font-weight: 700;
53+
}
54+
55+
.grid-item:visited {
56+
color: unset;
57+
}
58+
59+
.grid-item:hover,
60+
.grid-item:focus {
61+
text-decoration: none;
62+
filter: brightness(120%);
63+
}
64+
65+
.grid-item:active {
66+
filter: brightness(80%);
67+
}
68+
69+
.new-to-game { grid-area: new-to-game; background-color: #365314; }
70+
.know-game-learn-godot { grid-area: know-game-learn-godot; background-color: #134e4a; }
71+
.know-godot-learn-godot { grid-area: know-godot-learn-godot; background-color: #0c4a6e; }
72+
.contribute-to-godot { grid-area: contribute-to-godot; background-color: #701840; }
73+
</style>
74+
<div class="grid-container">
75+
<a class="grid-item new-to-game" href="about/introduction.html">I want to make a game,<br>I've never made a game before.</a>
76+
<a class="grid-item know-game-learn-godot" href="getting_started/first_2d_game/index.html">I know how to make a game,<br>I want to know how to use Godot.</a>
77+
<a class="grid-item know-godot-learn-godot" href="tutorials/index.html">I know how to use Godot,<br>I want to learn more advanced Godot topics.</a>
78+
<a class="grid-item contribute-to-godot" href="contributing/index.html">I know how to use Godot,<br>I want to work on the engine or the manual.</a>
79+
</div>
80+
<br>
81+
82+
You can also use the table of contents in the sidebar to access easily access
83+
any section of the documentation for your topic of interest. You can also use
84+
the search function in the top-left corner.
3485

3586
Get involved
3687
------------

‎tutorials/img/3d.png‎

123 KB
Loading

‎tutorials/index.rst‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
.. Sections below are split into two groups. First come meta sections, covering
2+
general matters. Below that different areas of the engine are listed.
3+
These sections are sorted alphabetically. Please keep them that way.
4+
5+
General
6+
-------
7+
8+
.. toctree::
9+
:maxdepth: 1
10+
:name: toc-learn-tutorials-general
11+
12+
best_practices/index
13+
editor/index
14+
migrating/index
15+
16+
Topics
17+
------
18+
19+
.. raw:: html
20+
21+
<style>
22+
.tutorial-section {
23+
display: block;
24+
padding: 1rem;
25+
margin: 0.375rem 0;
26+
border-radius: 0.375rem;
27+
color: hsla(0, 0%, 100%, 0.9);
28+
text-shadow: 0 0.125rem 0.125rem black;
29+
background: linear-gradient(to right, black, transparent), var(--background-image);
30+
background-size: cover;
31+
}
32+
33+
.tutorial-section:visited {
34+
color: unset;
35+
}
36+
37+
.tutorial-section:hover,
38+
.tutorial-section:focus {
39+
text-decoration: none;
40+
filter: brightness(120%);
41+
}
42+
43+
.tutorial-section:active {
44+
filter: brightness(80%);
45+
}
46+
</style>
47+
48+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="2d/index.html">
49+
<strong>2D</strong><br>
50+
Learn the 2D editor, rendering and level design functionality.
51+
</a>
52+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="3d/index.html">
53+
<strong>3D</strong><br>
54+
Learn the 3D editor, rendering and level design functionality.
55+
</a>
56+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="animation/index.html">
57+
<strong>Animation</strong><br>
58+
Learn to set up animations, play and create videos.
59+
</a>
60+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="assets_pipeline/index.html">
61+
<strong>Assets pipeline</strong><br>
62+
Learn to import and export 2D, 3D, audio resources.
63+
</a>
64+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="audio/index.html">
65+
<strong>Audio</strong><br>
66+
Learn to set up audio playback for sound effects and music in your project.
67+
</a>
68+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="export/index.html">
69+
<strong>Export</strong><br>
70+
Learn to package and export your project for distribution on different platforms.
71+
</a>
72+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="io/index.html">
73+
<strong>Input/output (I/O)</strong><br>
74+
Learn to read and write files, such as save games and configuration files.
75+
</a>
76+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="i18n/index.html">
77+
<strong>Internationalization (i18n)</strong><br>
78+
Learn to set up your project to support multiple languages.
79+
</a>
80+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="inputs/index.html">
81+
<strong>Inputs</strong><br>
82+
Learn setting up keyboard, mouse, controller and touch inputs for your project.
83+
</a>
84+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="math/index.html">
85+
<strong>Mathematics</strong><br>
86+
Learn vector math and matrices to better understand game development.
87+
</a>
88+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="navigation/index.html">
89+
<strong>Navigation</strong><br>
90+
Learn to make AI characters navigate seamlessly in a game world.
91+
</a>
92+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="networking/index.html">
93+
<strong>Networking</strong><br>
94+
Learn to communicate with a server using the high-level multiplayer API or low-level network APIs.
95+
</a>
96+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="performance/index.html">
97+
<strong>Performance</strong><br>
98+
Learn to diagnose performance issues and find optimizations in your project.
99+
</a>
100+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="physics/index.html">
101+
<strong>Physics</strong><br>
102+
Learn to set up rigid, character, soft and vehicle physics simulations in your project.
103+
</a>
104+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="platform/index.html">
105+
<strong>Platform-specific</strong><br>
106+
Learn platform-specific adjustments to make your project work across multiple platforms.
107+
</a>
108+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="plugins/index.html">
109+
<strong>Plugins</strong><br>
110+
Learn to use and create editor plugins to extend functionality.
111+
</a>
112+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="rendering/index.html">
113+
<strong>Rendering</strong><br>
114+
Learn to set up and optimize rendering features for your project.
115+
</a>
116+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="scripting/index.html">
117+
<strong>Scripting</strong><br>
118+
Learn to program games using GDScript and C#.
119+
</a>
120+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="shaders/index.html">
121+
<strong>Shaders</strong><br>
122+
Learn to create custom visual effects using text-based and visual shaders.
123+
</a>
124+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="ui/index.html">
125+
<strong>User Interface (UI)</strong><br>
126+
Learn to set up user interfaces.
127+
</a>
128+
<a class="tutorial-section" style="--background-image: url('../_images/3d.png')" href="xr/index.html">
129+
<strong>Mixed Reality (XR)</strong><br>
130+
Learn to set up Virtual Reality and Augmented Reality.
131+
</a>
132+
133+
.. FIXME: Image is not included in `_build/html/_images/` if the image directive below is not present.
134+
Figure out a way to force its inclusion so that we don't have to include this extraneous image.
135+
136+
.. image:: img/3d.png

0 commit comments

Comments
 (0)