diff --git a/Documentation/FirstProject/CreateRootPage.rst b/Documentation/FirstProject/CreateRootPage.rst index 580bbb7e..d6a3af23 100644 --- a/Documentation/FirstProject/CreateRootPage.rst +++ b/Documentation/FirstProject/CreateRootPage.rst @@ -1,9 +1,9 @@ :navigation-title: Root page .. include:: /Includes.rst.txt -.. index:: site, domain configuration, languages +.. index:: site, domain configuration, languages -.. _create-root-page: +.. _create-root-page: ========================= How to create a root page @@ -14,55 +14,114 @@ 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, you will learn how to create a root page in TYPO3 v13. -.. note:: +.. admonition:: Prerequisites + * You have TYPO3 :ref:`installed ` and can log into the backend. * You have access to the Page module and permission to create pages. - * You are familiar with the basic layout of the TYPO3 backend. + * You are familiar with the basic layout of the TYPO3 + `Backend `_. + +.. contents:: Steps to create a root package + +.. _create-root-page-new-page: + +Create a new page on root level +=============================== + +Once you log into the TYPO3 backend, locate the :guilabel:`Web > Page` module on the left-hand +side of the screen. Click on the Page module to open the page tree. + +.. figure:: /Images/ManualScreenshots/CreateRootPage/CreateNewPage.png + :alt: The "Page" module in the TYPO3 backend with a context menu to create a new page + +* In the page tree, right-click on the "root level" or the top node of the page + tree (if no pages exist yet, this will likely be labeled as "site" or similar). + A context menu will appear. + +* From the context menu, select "New". This will open a form for creating a new + page. + +.. _create-root-page-configure: + +Configure the newly created page +================================ + +Now, you need to configure the new page: + +* In the form that appears, give your new page a name. + This will be the label of your root page in the page tree. + +* Under the :guilabel:`Behavior` tab, look for the checkbox called + "Use as Root Page". Ensure this is checked. + +.. figure:: /Images/ManualScreenshots/CreateRootPage/SetRootPage.png + :alt: Page properties, tab "Behaviour", highlighting the "Use as root page" + +.. _create-root-page-save: + +Save the page +============= + +Once you have filled in the necessary information and selected the +"Use as Root Page" option, click the "Save" button at the top of the +form. Your new root page will now appear in the page tree on the left. +The page is only visible in the Backend at this point + +.. figure:: /Images/ManualScreenshots/CreateRootPage/PageCreated.png + :alt: Backend module "Page" with a newly created but still disabled root page + + The root page is disabled, therefore it is marked with the red icon. + You can enable it in the context menu. + +.. _create-root-page-site: -.. rst-class:: bignums-xxl -#. Access the Page module +Configure the site +================== - Once you log into the TYPO3 backend, locate the :guilabel:`Web > Page` module on the left-hand - side of the screen. Click on the Page module to open the page tree. +All sites must have a `site configuration `_. +If you have created a new page in the root of the page tree, the site configuration has been +created automatically and you can edit it: - .. figure:: /Images/ManualScreenshots/CreateRootPage/PageModule.png +.. figure:: /Images/ManualScreenshots/CreateRootPage/AutogeneratedSiteConfig.png + :alt: The auto-generated site of a new root page viewed in the "Sites" module -#. Create a new root page + You can find the auto-generated site configuration for your root page in the module :guilabel:`Site Management > Sites` - * In the page tree, right-click on the "root level" or the top node of the page - tree (if no pages exist yet, this will likely be labeled as "site" or similar). - A context menu will appear. +.. _create-root-page-site-package: - * From the context menu, select "New". This will open a form for creating a new - page. +Create a site package for the theme +=================================== - .. figure:: /Images/ManualScreenshots/CreateRootPage/CreateNewPage.png +The site needs a theme, also known as a "site package" in the TYPO3 world. Learn more about +`creating a site package `_. - * Alternatively, you can select a new page from the menu above the - page tree using drag & drop and place it in the page tree. +.. admonition:: Trouble shooting - .. figure:: /Images/ManualScreenshots/CreateRootPage/PageMenu.png + TYPO3 does not come with a default theme. You will have to install + or create a site package. If your site does not have a theme configured, + you will see a message like the the one below when trying to display + the page in the frontend: + .. figure:: /Images/ManualScreenshots/CreateRootPage/NoTypoScriptFound.png + :alt: Error message: No TypoScript record found! -#. Set the page type to root + Error message when no site package is installed or configured - Now, you need to configure the new page: + * `How to create a site package `_ + * `Troubleshooting "No TypoScript found!" `_ + * The `Introduction Package `_ + includes a ready-to-use theme and example content. - * In the form that appears, give your new page a name. - This will be the label of your root page in the page tree. +.. _create-root-page-enable: - * Under the :guilabel:`Behaviour` tab, look for the checkbox called - "Use as Root Page". Ensure this is checked. +Enable the page when you are ready +================================== - .. figure:: /Images/ManualScreenshots/CreateRootPage/SetRootPage.png +:guilabel:`Enable` the page as newly created pages are hidden by default. -#. Save the page +.. figure:: /Images/ManualScreenshots/CreateRootPage/EnablePage.png + :alt: A disabled root page and its context menu - Once you have filled in the necessary information and selected the - "Use as Root Page" option, click the "Save" button at the top of the - form. Your new root page will now appear in the page tree on the left. + Right click on the newly created page and chose `Enable` from the context menu. The red icon should disappear. - .. note:: - By default, a newly created page is disabled. You need to enable it to - make the page publicly visible. diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/AutogeneratedSiteConfig.png b/Documentation/Images/ManualScreenshots/CreateRootPage/AutogeneratedSiteConfig.png new file mode 100644 index 00000000..8c817383 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/CreateRootPage/AutogeneratedSiteConfig.png differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/CreateNewPage.png b/Documentation/Images/ManualScreenshots/CreateRootPage/CreateNewPage.png index 5f5eba78..2d728236 100644 Binary files a/Documentation/Images/ManualScreenshots/CreateRootPage/CreateNewPage.png and b/Documentation/Images/ManualScreenshots/CreateRootPage/CreateNewPage.png differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/EnablePage.png b/Documentation/Images/ManualScreenshots/CreateRootPage/EnablePage.png new file mode 100644 index 00000000..97e37fc4 Binary files /dev/null and b/Documentation/Images/ManualScreenshots/CreateRootPage/EnablePage.png differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/NoTypoScriptFound.png b/Documentation/Images/ManualScreenshots/CreateRootPage/NoTypoScriptFound.png new file mode 100644 index 00000000..90dce0fd Binary files /dev/null and b/Documentation/Images/ManualScreenshots/CreateRootPage/NoTypoScriptFound.png differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/PageCreated.png b/Documentation/Images/ManualScreenshots/CreateRootPage/PageCreated.png new file mode 100644 index 00000000..91f6794b Binary files /dev/null and b/Documentation/Images/ManualScreenshots/CreateRootPage/PageCreated.png differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/PageMenu.png b/Documentation/Images/ManualScreenshots/CreateRootPage/PageMenu.png deleted file mode 100644 index f18999f5..00000000 Binary files a/Documentation/Images/ManualScreenshots/CreateRootPage/PageMenu.png and /dev/null differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/PageModule.png b/Documentation/Images/ManualScreenshots/CreateRootPage/PageModule.png deleted file mode 100644 index 35b490d1..00000000 Binary files a/Documentation/Images/ManualScreenshots/CreateRootPage/PageModule.png and /dev/null differ diff --git a/Documentation/Images/ManualScreenshots/CreateRootPage/SetRootPage.png b/Documentation/Images/ManualScreenshots/CreateRootPage/SetRootPage.png index e5f8b962..f095ace6 100644 Binary files a/Documentation/Images/ManualScreenshots/CreateRootPage/SetRootPage.png and b/Documentation/Images/ManualScreenshots/CreateRootPage/SetRootPage.png differ