Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions Documentation/FirstProject/CreateRootPage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <siterecords>` 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,
Expand Down
10 changes: 8 additions & 2 deletions Documentation/FirstProject/Index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,17 @@
First project setup
===================

If you installed the `Default theme <https://docs.typo3.org/permalink/t3start:installation-typo3-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 <siterecords>`
to customize your installation.

This chapter demonstrates how to create your first small project in an empty
`TYPO3 Installation <https://docs.typo3.org/permalink/t3start:installation-index>`_.

Instead of following this chapter you can use a
`Project template for a quick start <https://docs.typo3.org/permalink/t3start:project-templates>`_.
There are also some
`Project templates for a quick start <https://docs.typo3.org/permalink/t3start:project-templates>`_.

.. card-grid::
:columns: 1
Expand Down
6 changes: 6 additions & 0 deletions Documentation/FirstProject/SiteManagement/Index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <siterecords>` to customize your
installation.

.. contents:: Table of contents

.. _siteconfiguration:
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 36 additions & 2 deletions Documentation/Installation/Install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When you are installing TYPO3 for the first time we recommend you use the
When you are installing TYPO3 for the first time we recommend that 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 <https://docs.typo3.org/permalink/t3start:creating-a-site-package>`_
later on.

.. code-block:: bash

ddev composer req typo3/theme-camino

.. seealso::

* `TYPO3 Theme: Camino <https://docs.typo3.org/permalink/typo3-theme-camino:start>`_

Directory structure after composer installation
-----------------------------------------------

Expand Down
54 changes: 54 additions & 0 deletions Documentation/Installation/Setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://docs.typo3.org/permalink/t3start:installation-typo3-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 <https://docs.typo3.org/permalink/t3start:settings-site-settings>`_
or create new `Sub pages <https://docs.typo3.org/permalink/t3editors:pages-creating>`_
and `Creating content <https://docs.typo3.org/permalink/t3editors:content-creating>`_.

.. 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 <https://docs.typo3.org/permalink/t3start:create-root-page>`_
if none was created automatically.