diff --git a/Documentation/FirstProject/CreateRootPage.rst b/Documentation/FirstProject/CreateRootPage.rst index 930a2470..bcc65326 100644 --- a/Documentation/FirstProject/CreateRootPage.rst +++ b/Documentation/FirstProject/CreateRootPage.rst @@ -9,6 +9,12 @@ How to create a root page ========================= +.. hint:: + If you choose "Create a basic site?" during setup you can skip this step. + + Proceed with chapter :ref:`Settings ` to customize your + installation. + In TYPO3, the root page is the starting point for any website. It serves as the top-level page in the page tree and is essential for configuring the site and making it available to users. In this tutorial, diff --git a/Documentation/FirstProject/Index.rst b/Documentation/FirstProject/Index.rst index d88d21cc..e0f7a1af 100644 --- a/Documentation/FirstProject/Index.rst +++ b/Documentation/FirstProject/Index.rst @@ -7,11 +7,17 @@ First project setup =================== +If you installed the `Default theme `_ +and chose to create a basic site during installation you already have a +root page, a site configuration and a basic theme / site package created +automatically. In this case you can proceed with chapter :ref:`Settings ` +to customize your installation. + This chapter demonstrates how to create your first small project in an empty `TYPO3 Installation `_. -Instead of following this chapter you can use a -`Project template for a quick start `_. +There are also some +`Project templates for a quick start `_. .. card-grid:: :columns: 1 diff --git a/Documentation/FirstProject/SiteManagement/Index.rst b/Documentation/FirstProject/SiteManagement/Index.rst index 4789dbd6..75594231 100644 --- a/Documentation/FirstProject/SiteManagement/Index.rst +++ b/Documentation/FirstProject/SiteManagement/Index.rst @@ -6,6 +6,12 @@ Site Management =============== +.. hint:: + If you choose "Create a basic site?" during setup you can skip this step. + + Proceed with chapter :ref:`Settings ` to customize your + installation. + .. contents:: Table of contents .. _siteconfiguration: diff --git a/Documentation/Images/ManualScreenshots/Theme/NewSite.png b/Documentation/Images/ManualScreenshots/Theme/NewSite.png new file mode 100644 index 00000000..8fe2986f Binary files /dev/null and b/Documentation/Images/ManualScreenshots/Theme/NewSite.png differ diff --git a/Documentation/Images/ManualScreenshots/Theme/NewSiteBackend.png b/Documentation/Images/ManualScreenshots/Theme/NewSiteBackend.png new file mode 100644 index 00000000..7cc98ca6 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/Theme/NewSiteBackend.png differ diff --git a/Documentation/Installation/Install.rst b/Documentation/Installation/Install.rst index 7d8dd356..46a6a781 100644 --- a/Documentation/Installation/Install.rst +++ b/Documentation/Installation/Install.rst @@ -46,7 +46,10 @@ TYPO3 via Composer, and run the setup. Copy and paste them into your terminal. ddev start # Install TYPO3 via Composer - ddev composer create-project "typo3/cms-base-distribution:^13" + ddev composer create-project "typo3/cms-base-distribution:^14" + + # Recommended: Require the default theme + ddev composer req typo3/theme-camino # Run TYPO3 CLI setup (database credentials are pre-filled) ddev typo3 setup --server-type=other --driver=mysqli --host=db --port=3306 --dbname=db --username=db --password=db @@ -141,10 +144,41 @@ Install TYPO3 using Composer: .. code-block:: bash - ddev composer create-project "typo3/cms-base-distribution:^13" + ddev composer create-project "typo3/cms-base-distribution:^14" + + # Recommended: Require the default theme + ddev composer req typo3/theme-camino You now have a **Composer-based TYPO3 installation**. +.. _installation-typo3-default-theme: + +Recommended: Require the default theme (Camino) +----------------------------------------------- + +.. versionadded:: 14.1 + + A default theme has been added to TYPO3. + +When you are installing TYPO3 for the first time we recommend you use the +default theme, :composer:`typo3/theme-camino` shipped with the TYPO3 Core. +Its main purpose is to build new sites more rapidly in TYPO3 v14. + +The theme is customizable in a limited way. It demonstrates basic page +structures as well as some default content elements. + +You can create your own customized theme, also called +`site package `_ +later on. + +.. code-block:: bash + + ddev composer req typo3/theme-camino + +.. seealso:: + + * `TYPO3 Theme: Camino `_ + Directory structure after composer installation ----------------------------------------------- diff --git a/Documentation/Installation/Setup.rst b/Documentation/Installation/Setup.rst index 31285032..4de5bfbc 100644 --- a/Documentation/Installation/Setup.rst +++ b/Documentation/Installation/Setup.rst @@ -93,3 +93,57 @@ Restart DDEV to apply the changes: .. code-block:: bash ddev restart + +.. _typo3-setup-next: + +Next steps: Create a basic website +=================================== + +If you installed the `Default theme `_ +and chose to create a basic site during installation, open the frontend and +have a look at the basic website in a browser of your choice: + +.. code-block:: bash + + ddev launch + +You should see a default website like the following: + +.. figure:: /Images/ManualScreenshots/Theme/NewSite.png + :alt: Frontend screenshot of a website using the default theme "Camino" with text "Welcome to your default website" + :zoom: lightbox + + Frontend of an empty website using the default theme "Camino" + +Access the TYPO3 backend: + +.. code-block:: bash + + ddev launch /typo3 + +Log in using the credentials you just created during the setup process. Navigate +to the :guilabel:`Content > Layout` module. You should see something like the +following: + +.. figure:: /Images/ManualScreenshots/Theme/NewSiteBackend.png + :alt: Backend screenshot of a freshly installed TYPO3 installation, demonstrating the Camino theme with its content areas in the "Content > Layout" module + :zoom: lightbox + + Backend of the same website, viewed in the :guilabel:`Content > Layout` module + +You can customize the example theme using the +`Site settings `_ +or create new `Sub pages `_ +and `Creating content `_. + +.. rubric:: Trouble shooting: + +If there is an error message instead, try clearing the cache: + +.. code-block:: bash + + ddev typo3 cache:flush -v + +If you can still see no default website, log into the backend and continue to +`create a root page manually `_ +if none was created automatically.