diff --git a/Build/DownloadSitePackage/data.json b/Build/DownloadSitePackage/data.json new file mode 100644 index 00000000..93770dc2 --- /dev/null +++ b/Build/DownloadSitePackage/data.json @@ -0,0 +1,13 @@ +{ + "base_package": "site_package_tutorial", + "typo3_version": 13.4, + "title": "My Site Package", + "description": "Site package to follow the tutorial. ", + "repository_url": "https://github.com/TYPO3-Documentation/TYPO3CMS-Tutorial-SitePackage", + "author": { + "name": "J. Doe", + "email": "j.doe@example.org", + "company": "My Vendor", + "homepage": "https://docs.typo3.org/permalink/t3sitepackage:start" + } +} diff --git a/Build/DownloadSitePackage/generate_sitepackage.sh b/Build/DownloadSitePackage/generate_sitepackage.sh new file mode 100644 index 00000000..6e32b445 --- /dev/null +++ b/Build/DownloadSitePackage/generate_sitepackage.sh @@ -0,0 +1,12 @@ +#!/bin/bash + +curl -X 'POST' \ + 'https://get.typo3.org/api/v1/sitepackage/' \ + -H 'accept: application/zip' \ + -H 'Content-Type: application/json' \ + -d @"$(dirname "$0")/data.json" --output Documentation/CodeSnippets/my_site_package.zip + +rm -rf Documentation/CodeSnippets/my_site_package/* +rm -rf Documentation/CodeSnippets/my_site_package/.* +unzip Documentation/CodeSnippets/my_site_package.zip -d "Documentation/CodeSnippets/my_site_package/" +rm Documentation/CodeSnippets/my_site_package.zip diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/ComposerJson.rst.txt b/Documentation/CodeSnippets/ExtensionConfiguration/ComposerJson.rst.txt deleted file mode 100644 index 3cff2bf8..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/ComposerJson.rst.txt +++ /dev/null @@ -1,28 +0,0 @@ -.. Extracted from EXT:site_package/composer.json - -.. code-block:: json - :caption: EXT:my-site-package/composer.json - :linenos: - - { - "name": "myvendor/my-site-package", - "type": "typo3-cms-extension", - "description": "Example site package from the site package tutorial", - "require": { - "typo3/cms-core": "^13.4|dev-main", - "typo3/cms-fluid-styled-content": "^13.4|dev-main" - }, - "homepage": "https://github.com/TYPO3-Documentation/TYPO3CMS-Tutorial-SitePackage-Code", - "license": "MIT", - "support": { - "issues": "https://github.com/TYPO3-Documentation/TYPO3CMS-Tutorial-SitePackage-Code/issues" - }, - "extra": { - "typo3/cms": { - "extension-key": "my_site_package" - }, - "branch-alias": { - "dev-master": "13.0.x-dev" - } - } - } diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-config.yaml b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-config.yaml deleted file mode 100644 index a989c41a..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-config.yaml +++ /dev/null @@ -1,5 +0,0 @@ -name: myvendor/my-site-package -label: "Example: My Site package" -dependencies: - - typo3/fluid-styled-content - - typo3/fluid-styled-content-css \ No newline at end of file diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-page-tsconfig.rst.txt b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-page-tsconfig.rst.txt deleted file mode 100644 index 55d189f1..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-page-tsconfig.rst.txt +++ /dev/null @@ -1,8 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/page.tsconfig - -.. code-block:: typoscript - :caption: EXT:site_package/Configuration/Sets/SitePackage/page.tsconfig - - @import './PageTsConfig/' - @import './PageTsConfig/BackendLayouts/' diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings-definitions-yaml.rst.txt b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings-definitions-yaml.rst.txt deleted file mode 100644 index 95ad56ab..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings-definitions-yaml.rst.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/settings.definitions.yaml - -.. code-block:: yaml - :caption: EXT:site_package/Configuration/Sets/SitePackage/settings.definitions.yaml - - categories: - SitePackage: - label: 'Site Package' - SitePackage.templates: - label: 'Templates' - parent: SitePackage - SitePackage.layout: - label: 'Layout' - parent: SitePackage - - settings: - SitePackage.template_path: - label: 'Page template path' - category: SitePackage.templates - description: 'Path to the templates of the Site Package.' - type: string - default: 'EXT:site_package/Resources/Private/PageView/' - - SitePackage.logo: - label: 'Logo' - category: SitePackage.layout - description: 'Path to the logo of Site Package.' - type: string - default: 'EXT:site_package/Resources/Public/Images/logo.svg' - - SitePackage.logo-alt: - label: 'Logo Alt text' - category: SitePackage.layout - description: 'Alternative text of the logo for the visually impaired' - type: string - default: 'Logo' - - SitePackage.favicon: - label: 'Favicon' - description: 'This icon is displayed in search engine results and in the browser tab' - category: SitePackage.layout - type: string - default: 'EXT:site_package/Resources/Public/Icons/favicon.ico' diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.rst.txt b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.rst.txt deleted file mode 100644 index 36f6a653..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.rst.txt +++ /dev/null @@ -1,19 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/settings.yaml - -.. code-block:: yaml - :caption: EXT:site_package/Configuration/Sets/SitePackage/settings.yaml - :linenos: - - styles: - templates: - layoutRootPath: EXT:site_package/Resources/Private/ContentElements/Layouts - partialRootPath: EXT:site_package/Resources/Private/ContentElements/Partials - templateRootPath: EXT:site_package/Resources/Private/ContentElements/Templates - content: - textmedia: - maxW: 1200 - maxWInText: 600 - linkWrap: - lightboxEnabled: true - lightboxCssClass: lightbox diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.yaml b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.yaml deleted file mode 100644 index 3c9914d0..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-settings.yaml +++ /dev/null @@ -1,12 +0,0 @@ -styles: - templates: - layoutRootPath: EXT:my_site_package/Resources/Private/ContentElements/Layouts - partialRootPath: EXT:my_site_package/Resources/Private/ContentElements/Partials - templateRootPath: EXT:my_site_package/Resources/Private/ContentElements/Templates - content: - textmedia: - maxW: 1200 - maxWInText: 600 - linkWrap: - lightboxEnabled: true - lightboxCssClass: lightbox \ No newline at end of file diff --git a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-setup.rst.txt b/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-setup.rst.txt deleted file mode 100644 index 7753562b..00000000 --- a/Documentation/CodeSnippets/ExtensionConfiguration/SitePackage-setup.rst.txt +++ /dev/null @@ -1,8 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript - -.. code-block:: typoscript - :caption: EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript - - @import './TypoScript/*.typoscript' - @import './TypoScript/Navigation/*.typoscript' diff --git a/Documentation/CodeSnippets/Fluid/Header.rst.txt b/Documentation/CodeSnippets/Fluid/Header.rst.txt deleted file mode 100644 index 6ac8ab88..00000000 --- a/Documentation/CodeSnippets/Fluid/Header.rst.txt +++ /dev/null @@ -1,22 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/PageView/Partials/Header.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/PageView/Partials/Header.html - :linenos: - - diff --git a/Documentation/CodeSnippets/Fluid/Image.rst.txt b/Documentation/CodeSnippets/Fluid/Image.rst.txt deleted file mode 100644 index cb827ffa..00000000 --- a/Documentation/CodeSnippets/Fluid/Image.rst.txt +++ /dev/null @@ -1,10 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html - :linenos: - - - - diff --git a/Documentation/CodeSnippets/Fluid/Layout.rst.txt b/Documentation/CodeSnippets/Fluid/Layout.rst.txt deleted file mode 100644 index 4b6a4cfe..00000000 --- a/Documentation/CodeSnippets/Fluid/Layout.rst.txt +++ /dev/null @@ -1,13 +0,0 @@ -.. code-block:: html - :caption: EXT:my_site_package/Resources/Private/PageView/Layouts/Layout.html - :linenos: - - - -
- - - -
- - diff --git a/Documentation/CodeSnippets/Fluid/Menu.rst.txt b/Documentation/CodeSnippets/Fluid/Menu.rst.txt deleted file mode 100644 index eee866c9..00000000 --- a/Documentation/CodeSnippets/Fluid/Menu.rst.txt +++ /dev/null @@ -1,20 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/PageView/Partials/Navigation/Menu.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/PageView/Partials/Navigation/Menu.html - :linenos: - - diff --git a/Documentation/CodeSnippets/Fluid/MenuSitemap.rst.txt b/Documentation/CodeSnippets/Fluid/MenuSitemap.rst.txt deleted file mode 100644 index fda062d7..00000000 --- a/Documentation/CodeSnippets/Fluid/MenuSitemap.rst.txt +++ /dev/null @@ -1,31 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html - :linenos: - - - - - - - - - - - - - - - - diff --git a/Documentation/CodeSnippets/Fluid/MenuSubpages.rst.txt b/Documentation/CodeSnippets/Fluid/MenuSubpages.rst.txt deleted file mode 100644 index a96b961c..00000000 --- a/Documentation/CodeSnippets/Fluid/MenuSubpages.rst.txt +++ /dev/null @@ -1,25 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html - :linenos: - - - - - - - - - - - diff --git a/Documentation/CodeSnippets/Fluid/PartialContent.rst.txt b/Documentation/CodeSnippets/Fluid/PartialContent.rst.txt deleted file mode 100644 index 386565ae..00000000 --- a/Documentation/CodeSnippets/Fluid/PartialContent.rst.txt +++ /dev/null @@ -1,11 +0,0 @@ -.. code-block:: html - :caption: Resources/Private/PageView/Partials/Content.html - :linenos: - - - - diff --git a/Documentation/CodeSnippets/Fluid/Stage.rst.txt b/Documentation/CodeSnippets/Fluid/Stage.rst.txt deleted file mode 100644 index 4cf9b396..00000000 --- a/Documentation/CodeSnippets/Fluid/Stage.rst.txt +++ /dev/null @@ -1,16 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/PageView/Partials/Stage.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/PageView/Partials/Stage.html - :linenos: - - -
- -
- diff --git a/Documentation/CodeSnippets/Fluid/TemplateDefault.rst.txt b/Documentation/CodeSnippets/Fluid/TemplateDefault.rst.txt deleted file mode 100644 index 34c49b2e..00000000 --- a/Documentation/CodeSnippets/Fluid/TemplateDefault.rst.txt +++ /dev/null @@ -1,17 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Resources/Private/PageView/Pages/Default.html - -.. code-block:: html - :caption: EXT:site_package/Resources/Private/PageView/Pages/Default.html - :linenos: - - - - - - -
- -
- - diff --git a/Documentation/CodeSnippets/PageLayout/_Subpage.tsconfig b/Documentation/CodeSnippets/PageLayout/_Subpage.tsconfig deleted file mode 100644 index 1b284b7e..00000000 --- a/Documentation/CodeSnippets/PageLayout/_Subpage.tsconfig +++ /dev/null @@ -1,42 +0,0 @@ -mod.web_layout.BackendLayouts { - Subpage { - title = Two Columns - icon = EXT:my_site_package/Resources/Public/Icons/BackendLayouts/twoColumns.svg - config { - backend_layout { - colCount = 2 - rowCount = 2 - rows { - 1 { - columns { - 1 { - name = Stage - colspan = 2 - colPos = 1 - identifier = stage - slideMode = slide - } - } - } - - 2 { - columns { - 1 { - name = Main Content - colPos = 0 - identifier = main - } - - 2 { - name = Sidebar - colPos = 2 - identifier = sidebar - slideMode = collectReverse - } - } - } - } - } - } - } -} diff --git a/Documentation/CodeSnippets/PageLayout/page.rst.txt b/Documentation/CodeSnippets/PageLayout/page.rst.txt deleted file mode 100644 index 9de52e4d..00000000 --- a/Documentation/CodeSnippets/PageLayout/page.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. code-block:: typoscript - :caption: EXT:my_site_package/Configuration/Sets/SitePackage/page.tsconfig - :linenos: - - @import 'EXT:my_site_package/Configuration/TsConfig/Page/PageLayout/*.tsconfig' diff --git a/Documentation/CodeSnippets/TypoScript/Setup.rst.txt b/Documentation/CodeSnippets/TypoScript/Setup.rst.txt deleted file mode 100644 index c4cfebb1..00000000 --- a/Documentation/CodeSnippets/TypoScript/Setup.rst.txt +++ /dev/null @@ -1,9 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript - -.. code-block:: typoscript - :caption: EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript - :linenos: - - @import './TypoScript/*.typoscript' - @import './TypoScript/Navigation/*.typoscript' diff --git a/Documentation/CodeSnippets/TypoScript/menu.rst.txt b/Documentation/CodeSnippets/TypoScript/menu.rst.txt deleted file mode 100644 index 4dd7d583..00000000 --- a/Documentation/CodeSnippets/TypoScript/menu.rst.txt +++ /dev/null @@ -1,12 +0,0 @@ -.. Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets -.. Extracted from EXT:site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript - -.. code-block:: typoscript - - page { - 10 { - dataProcessing { - 20 = menu - } - } - } diff --git a/Documentation/CodeSnippets/codesnippets.php b/Documentation/CodeSnippets/codesnippets.php deleted file mode 100644 index ee825532..00000000 --- a/Documentation/CodeSnippets/codesnippets.php +++ /dev/null @@ -1,97 +0,0 @@ -//github.com/TYPO3-Documentation/t3docs-codesnippets -// ddev exec vendor/bin/typo3 restructured_api_tools:php_domain public/fileadmin/TYPO3CMS-Tutorial-SitePackage/Documentation/CodeSnippets/ - -return [ - # code Snippets Setup - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript', - 'targetFileName' => 'TypoScript/Setup.rst.txt', - 'caption' => 'EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript', - 'showLineNumbers' => true - ], - #code Snippets Extension Configuration - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/settings.yaml', - 'targetFileName' => 'ExtensionConfiguration/SitePackage-settings.rst.txt', - 'caption' => 'EXT:site_package/Configuration/Sets/SitePackage/settings.yaml', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript', - 'targetFileName' => 'ExtensionConfiguration/SitePackage-setup.rst.txt', - 'caption' => 'EXT:site_package/Configuration/Sets/SitePackage/setup.typoscript', - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript', - 'targetFileName' => 'TypoScript/menu.rst.txt', - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/settings.definitions.yaml', - 'targetFileName' => 'ExtensionConfiguration/SitePackage-settings-definitions-yaml.rst.txt', - 'caption' => 'EXT:site_package/Configuration/Sets/SitePackage/settings.definitions.yaml', - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Configuration/Sets/SitePackage/page.tsconfig', - 'targetFileName' => 'ExtensionConfiguration/SitePackage-page-tsconfig.rst.txt', - 'caption' => 'EXT:site_package/Configuration/Sets/SitePackage/page.tsconfig', - 'language' => 'typoscript', - ], - - # code Snippets Fluid - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/PageView/Pages/Default.html', - 'targetFileName' => 'Fluid/TemplateDefault.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/PageView/Pages/Default.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/PageView/Partials/Header.html', - 'targetFileName' => 'Fluid/Header.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/PageView/Partials/Header.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/PageView/Partials/Navigation/Menu.html', - 'targetFileName' => 'Fluid/Menu.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/PageView/Partials/Navigation/Menu.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/PageView/Partials/Stage.html', - 'targetFileName' => 'Fluid/Stage.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/PageView/Partials/Stage.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html', - 'targetFileName' => 'Fluid/MenuSubpages.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html', - 'targetFileName' => 'Fluid/MenuSitemap.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html', - 'showLineNumbers' => true - ], - [ - 'action' => 'createCodeSnippet', - 'sourceFile' => 'EXT:site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html', - 'targetFileName' => 'Fluid/Image.rst.txt', - 'caption' => 'EXT:site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html', - 'showLineNumbers' => true - ], -]; diff --git a/Documentation/CodeSnippets/my_site_package/.editorconfig b/Documentation/CodeSnippets/my_site_package/.editorconfig new file mode 100644 index 00000000..ff05afd1 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/.editorconfig @@ -0,0 +1,70 @@ +# EditorConfig is awesome: http://EditorConfig.org + +# top-most EditorConfig file +root = true + +# Unix-style newlines with a newline ending every file +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true + +# CSS-Files +[*.css] +indent_style = space +indent_size = 4 + +# HTML-Files +[*.html] +indent_style = space +indent_size = 4 + +# TMPL-Files +[*.tmpl] +indent_style = space +indent_size = 4 + +# JS-Files +[*.js] +indent_style = space +indent_size = 4 + +# PHP-Files +[*.php] +indent_style = space +indent_size = 4 + +# MD-Files +[*.md] +indent_style = space +indent_size = 4 + +# ReST-Files +[*.rst] +indent_style = space +indent_size = 3 + +# TypoScript +[*.typoscript] +indent_style = space +indent_size = 4 + +# YML-Files +[{*.yml,*.yaml}] +indent_style = space +indent_size = 2 + +# package.json +[package.json] +indent_style = space +indent_size = 2 + +# composer.json +[composer.json] +indent_style = space +indent_size = 4 + +# phpstan +[*.neon] +indent_style = tab diff --git a/Documentation/CodeSnippets/my_site_package/Classes/.htaccess b/Documentation/CodeSnippets/my_site_package/Classes/.htaccess new file mode 100644 index 00000000..93169e4e --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Classes/.htaccess @@ -0,0 +1,2 @@ +Order deny,allow +Deny from all diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/.htaccess b/Documentation/CodeSnippets/my_site_package/Configuration/.htaccess new file mode 100644 index 00000000..93169e4e --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/.htaccess @@ -0,0 +1,2 @@ +Order deny,allow +Deny from all diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/default.tsconfig b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/default.tsconfig new file mode 100644 index 00000000..9c9c9a75 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/default.tsconfig @@ -0,0 +1,40 @@ +# +# BACKENDLAYOUT: DEFAULT +# +mod { + web_layout { + BackendLayouts { + default { + title = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.example + config { + backend_layout { + colCount = 1 + rowCount = 1 + rows { + 1 { + columns { + 1 { + name = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.column.stage + colPos = 1 + identifier = stage + slideMode = slide + } + } + } + 2 { + columns { + 1 { + name = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.column.normal + colPos = 0 + identifier = main + } + } + } + } + } + } + icon = EXT:my_site_package/Resources/Public/Icons/BackendLayouts/default.svg + } + } + } +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/subpage.tsconfig b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/subpage.tsconfig new file mode 100644 index 00000000..898ddf74 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/subpage.tsconfig @@ -0,0 +1,47 @@ +# +# BACKENDLAYOUT: EXAMPLE +# +mod { + web_layout { + BackendLayouts { + Subpage { + title = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.subpage + config { + backend_layout { + colCount = 2 + rowCount = 2 + rows { + 1 { + columns { + 1 { + name = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.column.stage + colPos = 1 + colspan = 2 + identifier = stage + slideMode = slide + } + } + } + 2 { + columns { + 1 { + name = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.column.normal + colPos = 0 + identifier = main + } + 2 { + name = LLL:EXT:my_site_package/Resources/Private/Language/locallang_be.xlf:backend_layout.column.right + colPos = 2 + identifier = sidebar + slideMode = collectReverse + } + } + } + } + } + } + icon = EXT:my_site_package/Resources/Public/Icons/BackendLayouts/subpage.svg + } + } + } +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/general.tsconfig b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/general.tsconfig new file mode 100644 index 00000000..05a49cec --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/general.tsconfig @@ -0,0 +1,27 @@ +TCEFORM { + pages { + # Hide "Frontend Layout" field as we use the "Backend Layout" for the complete layout + layout { + disabled = 1 + } + } + tt_content { + header_layout { + # Prevent H1 headlines in content elements + removeItems = 1 + } + } +} + +TCEMAIN { + pages { + # Pages will *not* have "(copy)" appended: + disablePrependAtCopy = 1 + # Pages will *not* be hidden upon copy: + disableHideAtCopy = 1 + } + tt_content { + # Content will *not* have "(copy)" appended: + disablePrependAtCopy = 1 + } +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/breadcrumb.typoscript b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/breadcrumb.typoscript new file mode 100644 index 00000000..ca963b5d --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/breadcrumb.typoscript @@ -0,0 +1,12 @@ +page { + 10 { + dataProcessing { + 30 = menu + 30 { + special = rootline + special.range = 0|-1 + as = breadcrumb + } + } + } +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript new file mode 100644 index 00000000..2355f8f4 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript @@ -0,0 +1,7 @@ +page { + 10 { + dataProcessing { + 20 = menu + } + } +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/configuration.typoscript b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/configuration.typoscript new file mode 100644 index 00000000..0fdf274a --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/configuration.typoscript @@ -0,0 +1,9 @@ +// Part 4: global site configuration +config { + # Adjust the title tag to be displayed as “website - page title” + pageTitleSeparator = - + pageTitleSeparator.noTrimWrap = | | | + + # Display the Admin Panel at the bottom of pages to logged in backend users + admPanel = 1 +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/page.typoscript b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/page.typoscript new file mode 100644 index 00000000..2d1df93d --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/page.typoscript @@ -0,0 +1,16 @@ +page = PAGE +page { + 10 = PAGEVIEW + 10 { + paths { + 0 = EXT:my_site_package/Resources/Private/PageView/ + 10 = {$MySitePackage.template_path} + } + + dataProcessing { + # makes content elements available as {content} in Fluid template + 10 = page-content + } + } + shortcutIcon = {$MySitePackage.favicon} +} diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/config.yaml b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/config.yaml new file mode 100644 index 00000000..4d5e9cb5 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/config.yaml @@ -0,0 +1,5 @@ +name: my-vendor/my-site-package +label: 'My Site Package' +dependencies: + - typo3/fluid-styled-content + - typo3/fluid-styled-content-css diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/page.tsconfig b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/page.tsconfig new file mode 100644 index 00000000..dce1853a --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/page.tsconfig @@ -0,0 +1,3 @@ +@import './PageTsConfig/' +@import './PageTsConfig/BackendLayouts/' + diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.definitions.yaml b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.definitions.yaml new file mode 100644 index 00000000..960c697f --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.definitions.yaml @@ -0,0 +1,38 @@ +categories: + MySitePackage: + label: 'My Site Package' + MySitePackage.templates: + label: 'Templates' + parent: MySitePackage + MySitePackage.layout: + label: 'Layout' + parent: MySitePackage + +settings: + MySitePackage.template_path: + label: 'Page template path' + category: MySitePackage.templates + description: 'Path to the templates of the My Site Package.' + type: string + default: 'EXT:my_site_package/Resources/Private/Templates/' + + MySitePackage.logo: + label: 'Logo' + category: MySitePackage.layout + description: 'Path to the logo of My Site Package.' + type: string + default: 'EXT:my_site_package/Resources/Public/Images/logo.svg' + + MySitePackage.logo-alt: + label: 'Logo Alt text' + category: MySitePackage.layout + description: 'Alternative text of the logo for the visually impaired' + type: string + default: 'Logo' + + MySitePackage.favicon: + label: 'Favicon' + description: 'This icon is displayed in search engine results and in the browser tab' + category: MySitePackage.layout + type: string + default: 'EXT:my_site_package/Resources/Public/Icons/favicon.ico' diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.yaml b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.yaml new file mode 100644 index 00000000..eabd3a33 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.yaml @@ -0,0 +1,12 @@ +styles: + templates: + layoutRootPath: EXT:my_site_package/Resources/Private/ContentElements/Layouts + partialRootPath: EXT:my_site_package/Resources/Private/ContentElements/Partials + templateRootPath: EXT:my_site_package/Resources/Private/ContentElements/Templates + content: + textmedia: + maxW: 1200 + maxWInText: 600 + linkWrap: + lightboxEnabled: true + lightboxCssClass: lightbox diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/setup.typoscript b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/setup.typoscript new file mode 100644 index 00000000..5509a99f --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/Sets/SitePackage/setup.typoscript @@ -0,0 +1,2 @@ +@import './TypoScript/*.typoscript' +@import './TypoScript/Navigation/*.typoscript' diff --git a/Documentation/CodeSnippets/my_site_package/Configuration/user.tsconfig b/Documentation/CodeSnippets/my_site_package/Configuration/user.tsconfig new file mode 100644 index 00000000..57d1ab09 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Configuration/user.tsconfig @@ -0,0 +1,13 @@ +options { + clearCache { + pages = 1 + } + pageTree { + showDomainNameWithTitle = 1 + showPageIdWithTitle = 1 + } + sites { + # These sets are already included, therefore hide them in the site configuration set editor + hideSets := addToList(typo3/fluid-styled-content,typo3/fluid-styled-content-css) + } +} diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.css b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.css new file mode 100644 index 00000000..6daed8e6 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.css @@ -0,0 +1,21 @@ +/* Custom Carousel Styling */ + +/* Change the color and size of indicators */ +.carousel-indicators button { + background-color: #007bff; /* Bootstrap primary color */ + width: 12px; + height: 12px; + border-radius: 50%; +} + +.carousel-indicators .active { + background-color: #0056b3; /* Darker shade for active indicator */ +} + +/* Style navigation buttons */ +.carousel-control-prev-icon, +.carousel-control-next-icon { + background-color: rgba(0, 0, 0, 0.5); /* Semi-transparent background */ + border-radius: 50%; /* Round buttons */ + padding: 10px; /* Space around the icon */ +} diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.js b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.js new file mode 100644 index 00000000..b06891ce --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/frontend.js @@ -0,0 +1,20 @@ +// Custom JavaScript for Bootstrap Carousel + +// Automatically pause the carousel after 5 seconds on page load +document.addEventListener('DOMContentLoaded', () => { + const carouselElement = document.querySelector('#carouselExampleIndicators'); + const carousel = new bootstrap.Carousel(carouselElement, { + interval: 5000, // Slide every 5 seconds + ride: 'carousel', + }); + + // Pause carousel after 5 seconds + setTimeout(() => { + carousel.pause(); + }, 5000); + + // Add custom behavior: Log to console when the slide changes + carouselElement.addEventListener('slid.bs.carousel', (event) => { + console.log(`Slide changed to: ${event.to}`); + }); +}); diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/icon.svg b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/icon.svg new file mode 100644 index 00000000..35bfc3dc --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/assets/icon.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/config.yaml b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/config.yaml new file mode 100644 index 00000000..a3a34931 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/config.yaml @@ -0,0 +1,17 @@ +name: my-site-package/carousel +typeName: my_site_package_carousel +group: default +prefixFields: true +prefixType: full +fields: + - identifier: carousel_items + type: Collection + foreign_field: parentid + fields: + - identifier: image + type: File + - identifier: header + type: Text + - identifier: description + type: Textarea + enableRichtext: true diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/language/labels.xlf b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/language/labels.xlf new file mode 100644 index 00000000..1e43b7aa --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/language/labels.xlf @@ -0,0 +1,32 @@ + + + +
+ + + Carousel + + + See also https://getbootstrap.com/docs/5.0/components/carousel/ + + + Carousel Items + + + Image + + + Header + + + Description + + + Previous + + + Next + + + + diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/backend-preview.html b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/backend-preview.html new file mode 100644 index 00000000..09052d7c --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/backend-preview.html @@ -0,0 +1,12 @@ + + +
+ +
+ +
+ + {item.header} +
+ +
diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/frontend.html b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/frontend.html new file mode 100644 index 00000000..63d6a840 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/carousel/templates/frontend.html @@ -0,0 +1,31 @@ + + + + diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/assets/icon.svg b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/assets/icon.svg new file mode 100644 index 00000000..b9702652 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/assets/icon.svg @@ -0,0 +1 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/config.yaml b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/config.yaml new file mode 100644 index 00000000..3258b16c --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/config.yaml @@ -0,0 +1,23 @@ +name: my-site-package/jumbotron +typeName: my_site_package_jumbotron +group: default +prefixFields: true +prefixType: full +fields: + - + identifier: header + useExistingField: true + - + identifier: bodytext + useExistingField: true + enableRichtext: true + - + identifier: button_text + type: Text + default: 'Read more' + min: 4 + max: 15 + - + identifier: button_link + type: Link + required: true diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/language/labels.xlf b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/language/labels.xlf new file mode 100644 index 00000000..83203b78 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/language/labels.xlf @@ -0,0 +1,20 @@ + + + +
+ + + Jumbotron + + + Call to action area with button + + + Button Text + + + Button Link + + + + diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/templates/frontend.html b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/templates/frontend.html new file mode 100644 index 00000000..81443799 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/ContentElements/jumbotron/templates/frontend.html @@ -0,0 +1,7 @@ +
+
+

{data.header}

+

{data.bodytext}

+ {data.button_text} +
+
diff --git a/Documentation/CodeSnippets/my_site_package/ContentBlocks/README.md b/Documentation/CodeSnippets/my_site_package/ContentBlocks/README.md new file mode 100644 index 00000000..7c344b5e --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ContentBlocks/README.md @@ -0,0 +1,25 @@ +# Custom content blocks + +For the custom content blocks to be displayed, the extension needs to be installed: + +``` +ddev composer install friendsoftypo3/content-blocks +``` + +## Kickstarting a new content block + +You can kickstart a new content block using the command: + +``` +ddev typo3 content-blocks:create +``` + +Afterwards run: + +``` +ddev typo3 cache:flush -g system +ddev typo3 extension:setup --extension=my_site_package +``` + +About how to create additional content blocks have a look at +[TYPO3 Content Blocks manual](https://docs.typo3.org/permalink/friendsoftypo3-content-blocks:start). diff --git a/Documentation/CodeSnippets/my_site_package/Initialisation/Site/main/config.yaml b/Documentation/CodeSnippets/my_site_package/Initialisation/Site/main/config.yaml new file mode 100644 index 00000000..ec8f29da --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Initialisation/Site/main/config.yaml @@ -0,0 +1,14 @@ +base: '/' +dependencies: + - my-vendor/my-site-package +languages: + - + title: English + enabled: true + languageId: 0 + base: / + locale: en_US.UTF-8 + navigationTitle: English + flag: us +rootPageId: 1 +websiteTitle: 'My Site Package' diff --git a/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml new file mode 100644 index 00000000..9af23da1 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml @@ -0,0 +1,2926 @@ + + +
+ 1.0 + + Example site + + To be used with {{ package.vendorNameAlternative }}/{{ package.packageNameAlternative }} + t3docs + + {{ package.author.email }} + 13.4.0 + Sat 5. October 2024 + + + + + + utf-8 + + + 1 + + + 2 + + + 9 + + + 10 + + + + + 3 + + + 4 + + + 8 + + + 5 + + + 6 + + + 11 + + + 7 + + + + + + + + + + 1 + 0 + Start page + + + + + 5 + 1 + Footer menu + + + + + 7 + 5 + Imprint + + + + + 11 + 5 + Contact + + + + + 6 + 5 + Data Privacy + + + + + 8 + 1 + Sitemap + + + + + 4 + 1 + Page 3 + + + + + 3 + 1 + Page 2 + + + + + 2 + 1 + Page 1 + + + + + 10 + 2 + Subpage 1 - 2 + + + + + 9 + 2 + Subpage 1 - 1 + + + +
+ + + 6 + 1 + My Jumbotron + + + + + 1 + 1 + TYPO3's Built-in Rich Text Editor + + + + bodytext + typolink_tag + <a href="http://ckeditor.com/" target="_blank" rel="noreferrer"> + + external + 363dcd56e89c2b9130f23c64fee73631 + http://ckeditor.com/ + + + + + + 2 + 1 + Examples of Rich Text Content Elements + + + + + 15 + 7 + Imprint + + + + + 17 + 11 + Contact + + + + + 14 + 6 + Data privacy + + + + + 8 + 8 + [No title] + + + + + 12 + 4 + Mercury + + + 2 +
sys_file_reference
+ + + + + + 13 + 4 + Venus + + + 3 + sys_file_reference
+ + + + + + 11 + 3 + Pluto + + + 1 + sys_file_reference
+ + + + + + 7 + 2 + Subpages + + + 2 + pages
+ + + + + + 4 + 2 + Header + + + + + 10 + 10 + Content on subpage 2 + + + + + 9 + 9 + Content on subpage 1 + + + + + + + 2 + 4 + 1024px-Mercury_clipart.svg.png + + + 6 +
sys_file
+ + + + + + 3 + 4 + 1024px-Venus_clipart.svg.png + + + 11 + sys_file
+ + + + + + 1 + 3 + Pluto.jpg + + + 12 + sys_file
+ + + + + + + + 6 + 0 + 1024px-Mercury_clipart.svg.png + 1 + + + 1 +
sys_file_storage
+ + + 6 + sys_file_metadata
+ + + + + + 11 + 0 + 1024px-Venus_clipart.svg.png + 1 + + + 1 + sys_file_storage
+ + + 11 + sys_file_metadata
+ + + + + + 12 + 0 + Pluto.jpg + 1 + + + 1 + sys_file_storage
+ + + 12 + sys_file_metadata
+ + + + + + + + 1 + 0 + fileadmin + 2 + + + +
+ + + 6 + 0 + 1024px-Mercury_clipart.svg.png + 2 + + + 6 +
sys_file
+ + + + + + 11 + 0 + 1024px-Venus_clipart.svg.png + 2 + + + 11 + sys_file
+ + + + + + 12 + 0 + Pluto.jpg + 2 + + + 12 + sys_file
+ + + + + + + + + + 1 +
+ + 1 + 1 + 1 +
+ + 1 +
+ + 1 + 1 + 1 +
+ + + + 1 + 1 + 1 +
+ + 1 + 1 + 1 + 1 + 1 +
+ + + + 1 + 1 + 1 +
+ + + + 1 +
+ + + + 1 +
+ + + + 1 +
+ + + + 1 +
+ + + + 1 + 1 +
+ + 1 + 1 +
+ + + + 1 +
+ + 1 +
+ + + + 1 + 1 +
+ + 1 + 1 +
+ + + + 1 +
+ + + + 1 +
+ + + + + 1024px-Mercury_clipart.svg.png + 1714803857 + + + 1024px-Venus_clipart.svg.png + 1714803857 + + + Pluto.jpg + 1714803857 + + +
+ + + + 1 + 0 + 1728108368 + 1728106968 + 0 + 0 + 0 + 0 + + 0 + + 0 + 0 + 0 + 0 + + {"doktype":"","title":"","slug":"","nav_title":"","subtitle":"","seo_title":"","description":"","no_index":"","no_follow":"","canonical_link":"","sitemap_changefreq":"","sitemap_priority":"","og_title":"","og_description":"","og_image":"","twitter_title":"","twitter_description":"","twitter_image":"","twitter_card":"","abstract":"","keywords":"","author":"","author_email":"","lastUpdated":"","layout":"","newUntil":"","backend_layout":"","backend_layout_next_level":"","content_from_pid":"","target":"","cache_timeout":"","cache_tags":"","is_siteroot":"","no_search":"","php_tree_stop":"","module":"","media":"","tsconfig_includes":"","TSconfig":"","l18n_cfg":"","hidden":"","nav_hide":"","starttime":"","endtime":"","extendToSubpages":"","fe_group":"","editlock":"","categories":"","rowDescription":""} + 0 + 0 + 0 + 0 + 1 + 1 + 31 + 31 + 1 + 1728108368 + 0 + 0 + 0 + 0 + 0.5 + 1 + Start page + / + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 1 + 0 + + 0 + pagets__Default + pagets__Subpage + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 6 + 1 + 1728108100 + 1728108100 + 0 + 0 + 0 + 0 + + 128 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 1 + + 0 + text + 0 + 0 + + + 0 + My Jumbotron + 0 + + + + <p>Some content for the jumbotron</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 1 + 1 + 1728107286 + 1728107286 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + TYPO3's Built-in Rich Text Editor + 0 + + + + <p>TYPO3 ships with the CKEditor (<a href="http://ckeditor.com/" target="_blank" rel="noreferrer"><u>ckeditor.com</u></a>) as there <i><strong>sophisticated</strong></i>&nbsp;built-in rich text editor (RTE).&nbsp;This editor contains all of the features one would expect from an Enterprise CMS, and is highly configurable and extendable to fit every project out there.</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + + + <a href="http://ckeditor.com/" target="_blank" rel="noreferrer"> + + external + 363dcd56e89c2b9130f23c64fee73631 + http://ckeditor.com/ + + + + + <p>TYPO3 ships with the CKEditor (<a href="{softref:363dcd56e89c2b9130f23c64fee73631}" target="_blank" rel="noreferrer"><u>ckeditor.com</u></a>) as there <i><strong>sophisticated</strong></i>&nbsp;built-in rich text editor (RTE).&nbsp;This editor contains all of the features one would expect from an Enterprise CMS, and is highly configurable and extendable to fit every project out there.</p> + + + + + + + 2 + 1 + 1728107331 + 1728107331 + 0 + 0 + 0 + 0 + + 512 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Examples of Rich Text Content Elements + 0 + + + + <p><strong>Continuous text:</strong> text, optional in <strong>bold</strong> or <i>italic</i> or in a combination of<i><strong> bold and italic</strong></i>.</p> +<p><strong>Special characters can be used</strong>: @ © ® ¢ ¼ ½ ¾ § ± a² m³ Ω π µ γ β α H<sub>2</sub>O</p> +<p><strong>Texts in foreign languages can be mixed on one page.</strong><br />The font has to be installed on the device though:</p> +<p>cyrillic: Русская версия<br />chinese: 中文版<br />arabic: الْعَرَبيّة</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 5 + 1 + 1728107053 + 1728107050 + 0 + 0 + 0 + 0 + 0 + 1024 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 0 + 0 + 0 + 0 + 0 + 0.5 + 254 + Footer menu + /footer-menu + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 7 + 5 + 1728107083 + 1728107078 + 0 + 0 + 0 + 0 + 0 + 512 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 0 + 0 + 0 + 0 + 0 + 0.5 + 1 + Imprint + /imprint + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 15 + 7 + 1728110193 + 1728110193 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Imprint + 0 + + + + <p>Insert your imprint here</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 11 + 5 + 1728110347 + 1728110336 + 0 + 0 + 0 + 0 + 0 + 384 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728110347 + 0 + 0 + 0 + 0 + 0.5 + 1 + Contact + /contact + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 17 + 11 + 1728110515 + 1728110515 + 0 + 0 + 0 + 0 + + 128 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Contact + 0 + + + + <p>Todo: Insert contact form</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 6 + 5 + 1728107067 + 1728107064 + 0 + 0 + 0 + 0 + 0 + 256 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 0 + 0 + 0 + 0 + 0 + 0.5 + 1 + Data Privacy + /data-privacy + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 14 + 6 + 1728110170 + 1728110170 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Data privacy + 0 + + + + <p>Insert you data privacy policies here</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 8 + 1 + 1728108009 + 1728108006 + 0 + 0 + 0 + 0 + 0 + 896 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728108009 + 0 + 0 + 0 + 0 + 0.5 + 1 + Sitemap + /sitemap + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 8 + 8 + 1728108340 + 1728108340 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + menu_sitemap + 0 + 0 + + + 0 + + 0 + + + + + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 4 + 1 + 1728107043 + 1728107040 + 0 + 0 + 0 + 0 + 0 + 768 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728107043 + 0 + 0 + 0 + 0 + 0.5 + 1 + Page 3 + /page-3 + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 2 + 4 + 1728110064 + 1728108714 + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 6 + + + 12 + tt_content + image + 1 + + + {"default":{"cropArea":{"x":0,"y":0,"width":1,"height":1},"selectedRatio":"NaN","focusArea":null}} + 0 + + + + db + + + 6 + sys_file
+ + + + + + + + 3 + 4 + 1728110078 + 1728109984 + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 11 + + + 13 + tt_content + image + 1 + + + {"default":{"cropArea":{"x":0,"y":0,"width":1,"height":1},"selectedRatio":"NaN","focusArea":null}} + 0 + + + + db + + + 11 + sys_file
+ + + + + + + + 12 + 4 + 1728110064 + 1728108714 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + {"CType":"","colPos":"","header":"","header_layout":"","header_position":"","date":"","header_link":"","subheader":"","bodytext":"","image":"","imagewidth":"","imageheight":"","imageborder":"","imageorient":"","imagecols":"","image_zoom":"","layout":"","frame_class":"","space_before_class":"","space_after_class":"","sectionIndex":"","linkToTop":"","categories":"","sys_language_uid":"","hidden":"","starttime":"","endtime":"","fe_group":"","editlock":"","rowDescription":""} + 0 + 0 + 0 + 0 + default + 0 + + 0 + textpic + 0 + 0 + + + 0 + Mercury + 0 + + + + <p><strong>Mercury</strong> is the first planet from the Sun and the smallest in the Solar System. In English, it is named after the ancient Roman god <i>Mercurius</i> (Mercury), god of commerce and communication, and the messenger of the gods.&nbsp;</p> + 1 + 0 + 250 + 0 + 17 + 0 + 0 + 1 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + db + + + 2 + sys_file_reference
+ + + + + + + + 13 + 4 + 1728110078 + 1728109984 + 0 + 0 + 0 + 0 + + 512 + + 0 + 0 + 0 + 0 + + {"CType":"","colPos":"","header":"","header_layout":"","header_position":"","date":"","header_link":"","subheader":"","bodytext":"","image":"","imagewidth":"","imageheight":"","imageborder":"","imageorient":"","imagecols":"","image_zoom":"","layout":"","frame_class":"","space_before_class":"","space_after_class":"","sectionIndex":"","linkToTop":"","categories":"","sys_language_uid":"","hidden":"","starttime":"","endtime":"","fe_group":"","editlock":"","rowDescription":""} + 0 + 0 + 0 + 0 + default + 0 + + 0 + textpic + 0 + 0 + + + 0 + Venus + 0 + + + + <p><strong>Venus</strong> is the second planet from the Sun. It is a terrestrial planet and is the closest in mass and size to its orbital neighbour Earth.&nbsp;</p> + 1 + 0 + 250 + 0 + 18 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + db + + + 3 + sys_file_reference
+ + + + + + + + 3 + 1 + 1728107033 + 1728107029 + 0 + 0 + 0 + 0 + 0 + 512 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728107033 + 0 + 0 + 0 + 0 + 0.5 + 1 + Page 2 + /page-2 + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 1 + 3 + 1728110148 + 1728108635 + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 12 + + + 11 + tt_content + image + 1 + + + {"default":{"cropArea":{"x":0,"y":0,"width":1,"height":1},"selectedRatio":"NaN","focusArea":null}} + 0 + + + + db + + + 12 + sys_file
+ + + + + + + + 11 + 3 + 1728110148 + 1728108635 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + {"CType":"","colPos":"","header":"","header_layout":"","header_position":"","date":"","header_link":"","subheader":"","bodytext":"","image":"","imagewidth":"","imageheight":"","imageborder":"","imageorient":"","imagecols":"","image_zoom":"","layout":"","frame_class":"","space_before_class":"","space_after_class":"","sectionIndex":"","linkToTop":"","categories":"","sys_language_uid":"","hidden":"","starttime":"","endtime":"","fe_group":"","editlock":"","rowDescription":""} + 0 + 0 + 0 + 0 + default + 0 + + 0 + textpic + 0 + 0 + + + 0 + Pluto + 0 + center + + + <p><strong>Pluto </strong>is a dwarf planet in the Kuiper belt, a ring of bodies beyond the orbit of Neptune. It is the ninth-largest and tenth-most-massive known object to directly orbit the Sun. It is the largest known trans-Neptunian object by volume, by a small margin, but is slightly less massive than Eris. Like other Kuiper belt objects, Pluto is made primarily of ice and rock and is much smaller than the inner planets. Pluto has roughly one-sixth the mass of the Moon, and one-third its volume.</p> + 1 + 0 + 250 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + db + + + 1 + sys_file_reference
+ + + + + + + + 2 + 1 + 1728107023 + 1728107019 + 0 + 0 + 0 + 0 + 0 + 256 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728107023 + 0 + 0 + 0 + 0 + 0.5 + 1 + Page 1 + /page-1 + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 7 + 2 + 1728110296 + 1728108281 + 0 + 0 + 0 + 0 + + 64 + + 0 + 0 + 0 + 0 + + {"CType":"","colPos":"","header":"","header_layout":"","header_position":"","date":"","header_link":"","subheader":"","pages":"","layout":"","frame_class":"","space_before_class":"","space_after_class":"","sectionIndex":"","linkToTop":"","categories":"","sys_language_uid":"","hidden":"","starttime":"","endtime":"","fe_group":"","editlock":"","rowDescription":""} + 0 + 0 + 0 + 0 + default + 2 + + 0 + menu_subpages + 0 + 0 + + + 0 + Subpages + 0 + + + + + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + 2 + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + db + + + 2 + pages
+ + + + + + + + 4 + 2 + 1728107987 + 1728107987 + 0 + 0 + 0 + 0 + + 128 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Header + 0 + + + + <h2>Header 2</h2> +<p>Lorem Ipsum dolor sit</p> +<h3>Header 3</h3> +<p>Lorem Ipsum dolor sit</p> +<pre>Some preformated text</pre> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 10 + 2 + 1728108258 + 1728108158 + 0 + 0 + 0 + 0 + 0 + 512 + + 0 + 0 + 0 + 0 + + {"hidden":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728108258 + 0 + 0 + 0 + 0 + 0.5 + 1 + Subpage 1 - 2 + /page-1/subpage-1-2 + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 10 + 10 + 1728108448 + 1728108432 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + {"CType":"","colPos":"","header":"","header_layout":"","header_position":"","date":"","header_link":"","subheader":"","bodytext":"","layout":"","frame_class":"","space_before_class":"","space_after_class":"","sectionIndex":"","linkToTop":"","categories":"","sys_language_uid":"","hidden":"","starttime":"","endtime":"","fe_group":"","editlock":"","rowDescription":""} + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Content on subpage 2 + 0 + + + + <p>TYPO3 offers editors full control over all content elements; even simple content elements like headers are accompanied by several configuration options. Site administrators may, for example, predefine several different header layouts for editors to utilize across the site.</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + 0 + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 9 + 2 + 1728108168 + 1728108139 + 0 + 0 + 0 + 0 + 0 + 256 + + 0 + 0 + 0 + 0 + + {"title":""} + 0 + 0 + 0 + 0 + 1 + 0 + 31 + 27 + 0 + 1728108168 + 0 + 0 + 0 + 0 + 0.5 + 1 + Subpage 1 - 1 + /page-1/subpage-1-1 + + 0 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + 0 + + 0 + 0 + + + + + + 0 + 0 + 0 + + 0 + + + + + 0 + 0 + + + + + 0 + + + 0 + + + + + + + 9 + 9 + 1728108422 + 1728108422 + 0 + 0 + 0 + 0 + + 256 + + 0 + 0 + 0 + 0 + + + 0 + 0 + 0 + 0 + default + 0 + + 0 + text + 0 + 0 + + + 0 + Content on subpage 1 + 0 + + + + <p>TYPO3 offers editors full control over all content elements; even simple content elements like headers are accompanied by several configuration options. Site administrators may, for example, predefine several different header layouts for editors to utilize across the site.</p> + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 2 + + 0 + + 0 + + 1 + 0 + + + + 0 + 0 + + 124 + 0 + 0 + 0 + + 0 + + + + 0 + 0 + + + + + + 6 + 0 + 1728108554 + 1728108554 + /user_upload/planets/1024px-Mercury_clipart.svg.png + a7404ea2ebebeb7c4b156f127e7de2c46734e1db + c085471add67c8837997cb8605cf7e11138b24d2 + png + 1024px-Mercury_clipart.svg.png + 10cc025d8583bfd3272bf8ee4b309edb79bad55f + 1714803857 + 1714803857 + 1 + 2 + image/png + 160706 + 0 + 0 + + + + db + + + 1 + sys_file_storage
+ + + + + db + + + 6 + sys_file_metadata
+ + + + + + + + 11 + 0 + 1728108554 + 1728108554 + /user_upload/planets/1024px-Venus_clipart.svg.png + 801249c6b91da980e20893939496307092d8534a + c085471add67c8837997cb8605cf7e11138b24d2 + png + 1024px-Venus_clipart.svg.png + b8a8591926c3640aa1dba9c9a4b0b16691ec71ea + 1714803857 + 1714803857 + 1 + 2 + image/png + 169658 + 0 + 0 + + + + db + + + 1 + sys_file_storage
+ + + + + db + + + 11 + sys_file_metadata
+ + + + + + + + 12 + 0 + 1728108554 + 1728108554 + /user_upload/planets/Pluto.jpg + 465a4cdabf8590f6b0c13122b3c4eb878003e342 + c085471add67c8837997cb8605cf7e11138b24d2 + jpg + Pluto.jpg + 2525cdd6f325f3fe72e671eacaccf6a56a496bc3 + 1714803857 + 1714803857 + 1 + 2 + image/jpeg + 80060 + 0 + 0 + + + + db + + + 1 + sys_file_storage
+ + + + + db + + + 12 + sys_file_metadata
+ + + + + + + + 1 + 0 + 1728107175 + 1728107175 + 0 + This is the local fileadmin/ directory. This storage mount has been created automatically by TYPO3. + 1 + + fileadmin + 1 + 1 + 1 + 1 + 1 + Local + <?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<T3FlexForms> + <data> + <sheet index="sDEF"> + <language index="lDEF"> + <field index="basePath"> + <value index="vDEF">fileadmin/</value> + </field> + <field index="pathType"> + <value index="vDEF">relative</value> + </field> + <field index="caseSensitive"> + <value index="vDEF">1</value> + </field> + </language> + </sheet> + </data> +</T3FlexForms> + + + + + + 6 + 0 + 1728108554 + 1728108554 + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 0 + 6 + + 1024 + 1024 + + + + db + + + 6 + sys_file
+ + + + + + + + 11 + 0 + 1728108554 + 1728108554 + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 0 + 11 + + 1024 + 1024 + + + + db + + + 11 + sys_file
+ + + + + + + + 12 + 0 + 1728108554 + 1728108554 + 0 + 0 + + + 0 + 0 + 0 + 0 + + + 0 + 12 + + 600 + 600 + + + + db + + + 12 + sys_file
+ + + + + + + + + 1024px-Mercury_clipart.svg.png + 1714803857 + 10cc025d8583bfd3272bf8ee4b309edb79bad55f + + + 1024px-Venus_clipart.svg.png + 1714803857 + b8a8591926c3640aa1dba9c9a4b0b16691ec71ea + + + Pluto.jpg + 1714803857 + 2525cdd6f325f3fe72e671eacaccf6a56a496bc3 + + + diff --git a/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/10cc025d8583bfd3272bf8ee4b309edb79bad55f b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/10cc025d8583bfd3272bf8ee4b309edb79bad55f new file mode 100644 index 00000000..0d9da127 Binary files /dev/null and b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/10cc025d8583bfd3272bf8ee4b309edb79bad55f differ diff --git a/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/2525cdd6f325f3fe72e671eacaccf6a56a496bc3 b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/2525cdd6f325f3fe72e671eacaccf6a56a496bc3 new file mode 100644 index 00000000..52cb79c0 Binary files /dev/null and b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/2525cdd6f325f3fe72e671eacaccf6a56a496bc3 differ diff --git a/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/b8a8591926c3640aa1dba9c9a4b0b16691ec71ea b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/b8a8591926c3640aa1dba9c9a4b0b16691ec71ea new file mode 100644 index 00000000..50fb4b8e Binary files /dev/null and b/Documentation/CodeSnippets/my_site_package/Initialisation/data.xml.files/b8a8591926c3640aa1dba9c9a4b0b16691ec71ea differ diff --git a/Documentation/CodeSnippets/my_site_package/README.md b/Documentation/CodeSnippets/my_site_package/README.md new file mode 100644 index 00000000..38cc81a3 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/README.md @@ -0,0 +1,74 @@ +# TYPO3 Site Package Tutorial Example + +This Site Package can be used to follow the [TYPO3 Site +Package Tutorial](https://docs.typo3.org/permalink/t3sitepackage:start@13.4). +Team. + +The tutorial describes the steps required to turn a basic design +template (HTML, CSS, JavaScript files, etc.) into a fully working, +mobile-responsive website. By following the steps of the Site Package +Tutorial, the reader builds a modern extension with all relevant files +stored at a central point and changes can easily be tracked in version +control. Despite the fact that TYPO3 supports several methods of +implementing websites, this approach is a very flexible and +professional way. + +## Installation with Composer + +Download the Site Package and save it into folder [packages/](https://docs.typo3.org/permalink/t3coreapi:directory-packages) +in the root of your TYPO3 installation. + +Require the Site Package using Composer and DDEV: + +``` +ddev composer req my-vendor/my-site-package:"@dev" +``` + +Or just Composer: + +``` +composer req my-vendor/my-site-package:"@dev" +``` + +## Classic TYPO3 installations + +When you intend to follow the Site Package Tutorial we recommend that you use a Composer-based installation +all paths and commands in the Tutorial are based on that type of installation. + +Download the Site Package and save it into folder `typo3conf/ext/` in the root of your TYPO3 installation. + +Activate extension "My Site Package" with key my_site_package in the Extension Manager. + +## Load Example data + +With DDEV call: + +``` +ddev typo3 extension:setup +``` + +Without DDEV: + +``` +vendor/bin/typo3 extension:setup +``` + +If automatic loading fails you can also try to use the import command: + +``` +ddev typo3 impexp:import EXT:my_site_package/Initialisation/data.xml +``` + +## Include the Set manually + +If you decide not to load the Example data, the Set of this Site Package needs to be included manually: + +Include the Set "My Site Package" in your site configuration. +See also: [Create a basic site set](https://docs.typo3.org/permalink/t3sitepackage:minimal-extension-siteset). + +You can also edit the file `config/sites/mysite/config.yaml` and include the following lines: + +``` +dependencies: + - my-vendor/my-site-package +``` diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/.htaccess b/Documentation/CodeSnippets/my_site_package/Resources/Private/.htaccess new file mode 100644 index 00000000..93169e4e --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/.htaccess @@ -0,0 +1,2 @@ +Order deny,allow +Deny from all diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Layouts/.gitkeep b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Layouts/.gitkeep new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Layouts/.gitkeep @@ -0,0 +1 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html new file mode 100644 index 00000000..d0a7d922 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html @@ -0,0 +1,3 @@ + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html new file mode 100644 index 00000000..66c50484 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html @@ -0,0 +1,24 @@ + + + + + + + + + + + + + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html new file mode 100644 index 00000000..ff759904 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html @@ -0,0 +1,18 @@ + + + + + + + + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang.xlf b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang.xlf new file mode 100644 index 00000000..11b385ca --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang.xlf @@ -0,0 +1,11 @@ + + + +
+ J. Doe + j.doe@example.org +
+ + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_be.xlf b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_be.xlf new file mode 100644 index 00000000..a32573fe --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_be.xlf @@ -0,0 +1,26 @@ + + + +
+ J. Doe + j.doe@example.org +
+ + + Default + + + Subpage + + + Stage + + + Normal + + + Right + + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_db.xlf b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_db.xlf new file mode 100644 index 00000000..11b385ca --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/Language/locallang_db.xlf @@ -0,0 +1,11 @@ + + + +
+ J. Doe + j.doe@example.org +
+ + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Layouts/PageLayout.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Layouts/PageLayout.html new file mode 100644 index 00000000..8768fa92 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Layouts/PageLayout.html @@ -0,0 +1,9 @@ + + +
+ + + +
+ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Default.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Default.html new file mode 100644 index 00000000..aae3534b --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Default.html @@ -0,0 +1,10 @@ + + + + + +
+ +
+ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Subpage.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Subpage.html new file mode 100644 index 00000000..4db1efbc --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Pages/Subpage.html @@ -0,0 +1,18 @@ + + + + + + +
+
+
+ +
+
+ +
+
+
+ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Content.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Content.html new file mode 100644 index 00000000..073e6525 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Content.html @@ -0,0 +1,7 @@ + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Footer.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Footer.html new file mode 100644 index 00000000..9d29b2ea --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Footer.html @@ -0,0 +1,13 @@ +
+
+
+ + + + + © now {site.configuration.websiteTitle} +
+ + +
+
diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Header.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Header.html new file mode 100644 index 00000000..8b4ec260 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Header.html @@ -0,0 +1,15 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Breadcrumb.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Breadcrumb.html new file mode 100644 index 00000000..c1b4c28b --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Breadcrumb.html @@ -0,0 +1,22 @@ + +
+ +
+ diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/FooterMenu.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/FooterMenu.html new file mode 100644 index 00000000..270a85da --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/FooterMenu.html @@ -0,0 +1,4 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html new file mode 100644 index 00000000..2a326864 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html @@ -0,0 +1,13 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Stage.html b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Stage.html new file mode 100644 index 00000000..f4c88252 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Stage.html @@ -0,0 +1,9 @@ + +
+ +
+ diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Css/main.css b/Documentation/CodeSnippets/my_site_package/Resources/Public/Css/main.css new file mode 100644 index 00000000..37ee76e5 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Css/main.css @@ -0,0 +1,21 @@ +:root { + --bs-border-radius: 0; + --bs-border-radius-sm: 0; + --bs-border-radius-lg: 0; + --bs-primary: #ff8700; + --bs-primary-bg-subtle: #ffcc99; +} + +.nav { + --bs-nav-link-color: var(--bs-body-color); + --bs-nav-link-hover-color: var(--bs-dark); +} + +.navbar-expand-lg .navbar-nav .nav-link.active { + border-bottom: 2px solid var(--bs-primary); +} + +.navbar-expand-lg .navbar-nav .nav-link:hover { + border-bottom: 2px solid var(--bs-primary-bg-subtle); +} + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Fonts/.gitkeep b/Documentation/CodeSnippets/my_site_package/Resources/Public/Fonts/.gitkeep new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Fonts/.gitkeep @@ -0,0 +1 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/default.svg b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/default.svg new file mode 100644 index 00000000..98309168 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/default.svg @@ -0,0 +1,13 @@ + + + + + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/subpage.svg b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/subpage.svg new file mode 100644 index 00000000..fdae6fd5 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/BackendLayouts/subpage.svg @@ -0,0 +1,16 @@ + + + + + + + + + + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/Extension.svg b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/Extension.svg new file mode 100644 index 00000000..eab6182d --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/Extension.svg @@ -0,0 +1 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/favicon.ico b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/favicon.ico new file mode 100644 index 00000000..90fdfe18 Binary files /dev/null and b/Documentation/CodeSnippets/my_site_package/Resources/Public/Icons/favicon.ico differ diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/Images/logo.svg b/Documentation/CodeSnippets/my_site_package/Resources/Public/Images/logo.svg new file mode 100644 index 00000000..eab6182d --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/Images/logo.svg @@ -0,0 +1 @@ + diff --git a/Documentation/CodeSnippets/my_site_package/Resources/Public/JavaScript/main.js b/Documentation/CodeSnippets/my_site_package/Resources/Public/JavaScript/main.js new file mode 100644 index 00000000..a5e49024 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/Resources/Public/JavaScript/main.js @@ -0,0 +1 @@ +console.log('WE LOVE TYPO3'); diff --git a/Documentation/CodeSnippets/my_site_package/composer.json b/Documentation/CodeSnippets/my_site_package/composer.json new file mode 100644 index 00000000..e427bd21 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/composer.json @@ -0,0 +1,26 @@ +{ + "name": "my-vendor/my-site-package", + "type": "typo3-cms-extension", + "description": "Site package to follow the tutorial.", + "homepage": "https://docs.typo3.org/permalink/t3sitepackage:start", + "license": ["GPL-2.0-or-later"], + "keywords": ["TYPO3 CMS"], + "require": { + "typo3/cms-core": "^13.4", + "typo3/cms-rte-ckeditor": "^13.4", + "typo3/cms-fluid-styled-content": "^13.4" + }, + "suggest": { + "friendsoftypo3/content-blocks": "Allows to create custom content elements. " + }, + "autoload": { + "psr-4": { + "MyVendor\\MySitePackage\\": "Classes/" + } + }, + "extra": { + "typo3/cms": { + "extension-key": "my_site_package" + } + } +} diff --git a/Documentation/CodeSnippets/my_site_package/ext_emconf.php b/Documentation/CodeSnippets/my_site_package/ext_emconf.php new file mode 100644 index 00000000..6e50bad5 --- /dev/null +++ b/Documentation/CodeSnippets/my_site_package/ext_emconf.php @@ -0,0 +1,29 @@ + 'My Site Package', + 'description' => 'Site package to follow the tutorial.', + 'category' => 'templates', + 'constraints' => [ + 'depends' => [ + 'typo3' => '13.4.0-13.4.99', + 'fluid_styled_content' => '13.4.0-13.4.99', + 'rte_ckeditor' => '13.4.0-13.4.99', + ], + 'conflicts' => [ + ], + ], + 'autoload' => [ + 'psr-4' => [ + 'MyVendor\\MySitePackage\\' => 'Classes', + ], + ], + 'state' => 'stable', + 'uploadfolder' => 0, + 'createDirs' => '', + 'clearCacheOnLoad' => 1, + 'author' => 'J. Doe', + 'author_email' => 'j.doe@example.org', + 'author_company' => 'My Vendor', + 'version' => '1.0.0', +]; diff --git a/Documentation/ContentElementRendering/Index.rst b/Documentation/ContentElementRendering/Index.rst index 2db55c52..501ecd99 100644 --- a/Documentation/ContentElementRendering/Index.rst +++ b/Documentation/ContentElementRendering/Index.rst @@ -48,9 +48,9 @@ Clipboard instead, then save it to the following file: styles: templates: - templateRootPath: 'EXT:site_package/Resources/Private/ContentElements/Templates' - partialRootPath: 'EXT:site_package/Resources/Private/ContentElements/Partials' - layoutRootPath: 'EXT:site_package/Resources/Private/ContentElements/Layouts' + templateRootPath: 'EXT:my_site_package/Resources/Private/ContentElements/Templates' + partialRootPath: 'EXT:my_site_package/Resources/Private/ContentElements/Partials' + layoutRootPath: 'EXT:my_site_package/Resources/Private/ContentElements/Layouts' Then close the settings editor without saving. You can now start overriding the templates: @@ -85,7 +85,9 @@ into folder :path:`packages/my_site_package/Resources/Private/ContentElements/Te Edit the file to add some classes as used in menus in Bootstrap, for example like this: -.. include:: /CodeSnippets/Fluid/MenuSubpages.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html + :caption: packages/my_site_package/Resources/Private/ContentElements/Templates/MenuSubpages.html + :linenos: In most parts the changes we made are pretty straight forward. In line 9 we use the `Fluid inline notation `_ @@ -102,7 +104,9 @@ In a similar fashion we now copy and adjust the template for the sitemap from into folder :path:`packages/site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html` and then adjust it: -.. include:: /CodeSnippets/Fluid/MenuSitemap.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html + :caption: packages/my_site_package/Resources/Private/ContentElements/Templates/MenuSitemap.html + :linenos: We want to adjust the HTML output of the sitemap for different levels. The original template however gives us no means to output the level. @@ -154,4 +158,6 @@ By overriding this one partial we can add a class to all images that are displayed with the "Image" or "Text with Media" content elements. For example we could display all images as circles by adding the class `rounded-circle`: -.. include:: /CodeSnippets/Fluid/Image.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html + :caption: packages/my_site_package/Resources/Private/ContentElements/Partials/Media/Rendering/Image.html + :linenos: diff --git a/Documentation/ContentMapping/AddContent.rst b/Documentation/ContentMapping/AddContent.rst index 14fe293a..b23a4cff 100644 --- a/Documentation/ContentMapping/AddContent.rst +++ b/Documentation/ContentMapping/AddContent.rst @@ -17,29 +17,57 @@ You can add additonal content in the backend. Go to in the column labelled "*Main*" and choose the "Regular Text Element" content element. -.. include:: /ContentMapping/_images/AddNewContentElement.rst.txt +.. figure:: /Images/ContentMapping/AddNewContentElement.png + :class: with-shadow + :alt: Create new content element -.. include:: /ContentMapping/_images/ChooseRegularTextElement.rst.txt + Create new content element + +.. figure:: /Images/ContentMapping/ChooseRegularTextElement.png + :class: with-shadow + :alt: Choose "Regular Text Element" + + Choose "Regular Text Element" Enter a headline and some arbitrary text in the Rich Text Editor (RTE). -.. include:: /ContentMapping/_images/EditRegularTextElement1.rst.txt +.. figure:: /Images/ContentMapping/EditRegularTextElement1.png + :class: with-shadow + :alt: Enter a headline + + Enter a headline + +.. figure:: /Images/ContentMapping/EditRegularTextElement2.png + :class: with-shadow + :alt: Enter some arbitrary text in the Rich Text Editor (RTE) -.. include:: /ContentMapping/_images/EditRegularTextElement2.rst.txt + Enter some arbitrary text in the Rich Text Editor (RTE) Save your changes by clicking button :guilabel:`Save` at the top. You can return to the previous view by clicking :guilabel:`Close`. -.. include:: /ContentMapping/_images/SaveAndCloseRegularTextElement.rst.txt +.. figure:: /Images/ContentMapping/SaveAndCloseRegularTextElement.png + :class: with-shadow + :alt: Save and close the new content element + + Save and close the new content element :ref:`Preview the page ` by clicking button :guilabel:`View webpage`. -.. include:: /ContentMapping/_images/PreviewPageButton.rst.txt +.. figure:: /Images/ContentMapping/PreviewPageButton.png + :class: with-shadow + :alt: View webpage button + + View webpage button Check that the content is displayed as expected. -.. include:: /ContentMapping/_images/VerifyPageContent.rst.txt +.. figure:: /Images/ContentMapping/VerifyPageContent.png + :class: with-shadow + :alt: Verify if your new content is displayed on the page + + Verify if your new content is displayed on the page Whenever you edit the content elements on a page the cache of the current page is automatically deleted. If the content diff --git a/Documentation/ContentMapping/Index.rst b/Documentation/ContentMapping/Index.rst index c8aa7dfe..b8c85b3c 100644 --- a/Documentation/ContentMapping/Index.rst +++ b/Documentation/ContentMapping/Index.rst @@ -31,8 +31,8 @@ display the content in the next steps. Your site set configuration should now look like this: -.. literalinclude:: /CodeSnippets/ExtensionConfiguration/SitePackage-config.yaml - :caption: EXT:my_site_package/Configuration/Sets/SitePackage/config.yaml +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/config.yaml + :caption: packages/my_site_package/Configuration/Sets/SitePackage/config.yaml :language: yaml :linenos: @@ -52,7 +52,9 @@ By placing the file within the site set, you created in step :ref:`Create a basic site set `, the newly created file is loaded within the page tree of your site automatically: -.. include:: /CodeSnippets/PageLayout/page.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/page.tsconfig + :caption: packages/my_site_package/Configuration/Sets/SitePackage/page.tsconfig + :linenos: This file automatically includes all `.tsconfig` files from the designated folder in which we will store the page layouts. @@ -62,7 +64,7 @@ one for the stage. .. literalinclude:: _codesnippets/_Default.tsconfig :language: typoscript - :caption: EXT:my_site_package/Configuration/TsConfig/Page/PageLayout/Default.tsconfig + :caption: packages/my_site_package/Configuration/TsConfig/Page/PageLayout/Default.tsconfig :linenos: .. versionchanged:: TYPO3 13 @@ -77,12 +79,18 @@ one for the stage. When you make changes to the files of an extension it is usually necessary to flush all caches by hitting the button. -.. include:: /Images/AutomaticScreenshots/FlushAllCaches.rst.txt +.. figure:: /Images/AutomaticScreenshots/FlushAllCaches.png + :class: with-shadow + + Flush all caches After flushing the all caches the new backend layout is available in the page properties at :guilabel:` Appearance > Page Layout > Backend Layout`. -.. include:: /Images/AutomaticScreenshots/ChooseBackendLayout.rst.txt +.. figure:: /Images/AutomaticScreenshots/ChooseBackendLayout.png + :class: with-shadow + + Choose the backend layout .. _choose_page_layout: @@ -97,7 +105,10 @@ If you followed step :ref:`Load the example data automatically ` the areas "Stage" and "Main" should already contain some example content. -.. include:: /Images/AutomaticScreenshots/CreateNewContentElement.rst.txt +.. figure:: /Images/AutomaticScreenshots/CreateNewContentElement.png + :class: with-shadow + + Create new content element In the database each content element record is stored in the table :sql:`tt_content`. This table has a column called `colPos`. If the value stored @@ -202,7 +213,9 @@ the partial: The partial then looks like this: -.. include:: /CodeSnippets/Fluid/PartialContent.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Content.html + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Content.html + :linenos: .. _content-element-typoscript: diff --git a/Documentation/ContentMapping/Stage.rst b/Documentation/ContentMapping/Stage.rst index 6772be54..f5295e96 100644 --- a/Documentation/ContentMapping/Stage.rst +++ b/Documentation/ContentMapping/Stage.rst @@ -50,4 +50,6 @@ The content elements will be automatically found and provided to your template. Therefore the template for the area "Stage" looks no different from the one for the main area except that is uses the corresponding variable of course: -.. include:: /CodeSnippets/Fluid/Stage.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Stage.html + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Stage.html + :linenos: diff --git a/Documentation/ContentMapping/SubpageLayout.rst b/Documentation/ContentMapping/SubpageLayout.rst index bd10eaec..6c8698d3 100644 --- a/Documentation/ContentMapping/SubpageLayout.rst +++ b/Documentation/ContentMapping/SubpageLayout.rst @@ -29,9 +29,9 @@ We now create a subpage layout with two columns and a row for the stage in a new file :file:`packages/my-site-package/Configuration/TsConfig/Page/PageLayout/Subpage.tsconfig` containing :ref:`page TSconfig `. : -.. literalinclude:: /CodeSnippets/PageLayout/_Subpage.tsconfig +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/subpage.tsconfig :language: typoscript - :caption: packages/my-site-package/Configuration/TsConfig/Page/PageLayout/Subpage.tsconfig + :caption: packages/my_site_package/Configuration/Sets/SitePackage/PageTsConfig/BackendLayouts/subpage.tsconfig :linenos: .. _cm-switch_backend_layout: @@ -44,7 +44,11 @@ at :guilabel:` Appearance > Page Layout > Backend Layout`. Edit the page properties of `Start page` to use the backend layout "Two Columns" for subpages. -.. include:: _images/SwitchBackendLayoutForSubpages.rst.txt +.. figure:: /Images/ContentMapping/SwitchBackendLayoutForSubpages.png + :class: with-shadow + :alt: Switch to the Backend Layout "Two Columns" for subpages + + Switch to the Backend Layout "Two Columns" for subpages After saving you will be able to see on "Page 1" that the content of the columns "main" and "stage" remains unchanged while there is a third column "sidebar". @@ -54,8 +58,18 @@ use the same colPos number for these columns. The pages generated in step Create initial pages already contain "Menu of subpages" an example content in "sidebar" column. -.. include:: _images/BackendLayoutTwoColumns.rst.txt +.. figure:: /Images/ContentMapping/BackendLayoutTwoColumns.png + :class: with-shadow + :alt: A new column "Sidebar" appears + + A new column "Sidebar" appears + Preview the page once more. A sidebar will appear in the frontend: -.. include:: _images/TwoColumnsPreviewPage.rst.txt +.. figure:: /Images/ContentMapping/TwoColumnsPreviewPage.png + :class: with-shadow + :alt: The sidebar appears in the frontend + + The sidebar appears in the frontend + diff --git a/Documentation/ContentMapping/TypoScript.rst b/Documentation/ContentMapping/TypoScript.rst index 9af31d73..4a3d5c0d 100644 --- a/Documentation/ContentMapping/TypoScript.rst +++ b/Documentation/ContentMapping/TypoScript.rst @@ -29,7 +29,7 @@ Familiarize yourself with the TypoScript `@import` syntax first: Import the TypoScript from a different location =============================================== -Create a new folder called :path:`Configuration/Sets/MySet/TypoScript`. In this +Create a new folder called :path:`Configuration/Sets/SitePackage/TypoScript`. In this create a file called :file:`page.typoscript` and copy the content from file :file:`Configuration/Sets/SitePackage/setup.typoscript` into it. @@ -52,7 +52,9 @@ We will create more TypoScript files in the next steps. We could import them file by file. But as the order will not matter we can import all of them via wildcard: -.. include:: /CodeSnippets/TypoScript/Setup.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/setup.typoscript + :caption: packages/my_site_package/Configuration/Sets/SitePackage/setup.typoscript + :linenos: Only files from the folder directly will be imported. If you create subfolders later on you have to import them separately. @@ -68,7 +70,7 @@ Your :path:`Configuration` directory should now have the following structure: :level: 4 :show-file-icons: true - * EXT:my_sitepackage/Configuration + * packages/my_site_package/Configuration * Sets diff --git a/Documentation/ContentMapping/_images/AddNewContentElement.rst.txt b/Documentation/ContentMapping/_images/AddNewContentElement.rst.txt deleted file mode 100644 index babbd2ee..00000000 --- a/Documentation/ContentMapping/_images/AddNewContentElement.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/AddNewContentElement.png - :class: with-shadow - :caption: Create new content element - - Create new content element diff --git a/Documentation/ContentMapping/_images/BackendLayoutTwoColumns.rst.txt b/Documentation/ContentMapping/_images/BackendLayoutTwoColumns.rst.txt deleted file mode 100644 index 9b5ed71c..00000000 --- a/Documentation/ContentMapping/_images/BackendLayoutTwoColumns.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/BackendLayoutTwoColumns.png - :class: with-shadow - :caption: A new column "Sidebar" appears - - A new column "Sidebar" appears diff --git a/Documentation/ContentMapping/_images/ChooseRegularTextElement.rst.txt b/Documentation/ContentMapping/_images/ChooseRegularTextElement.rst.txt deleted file mode 100644 index a0f9849c..00000000 --- a/Documentation/ContentMapping/_images/ChooseRegularTextElement.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/ChooseRegularTextElement.png - :class: with-shadow - :caption: Choose "Regular Text Element" - - Choose "Regular Text Element" diff --git a/Documentation/ContentMapping/_images/EditRegularTextElement1.rst.txt b/Documentation/ContentMapping/_images/EditRegularTextElement1.rst.txt deleted file mode 100644 index 931a4adb..00000000 --- a/Documentation/ContentMapping/_images/EditRegularTextElement1.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/EditRegularTextElement1.png - :class: with-shadow - :caption: Enter a headline - - Enter a headline diff --git a/Documentation/ContentMapping/_images/EditRegularTextElement2.rst.txt b/Documentation/ContentMapping/_images/EditRegularTextElement2.rst.txt deleted file mode 100644 index 4d452d80..00000000 --- a/Documentation/ContentMapping/_images/EditRegularTextElement2.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/EditRegularTextElement2.png - :class: with-shadow - :caption: Enter some arbitrary text in the Rich Text Editor (RTE) - - Enter some arbitrary text in the Rich Text Editor (RTE) diff --git a/Documentation/ContentMapping/_images/PreviewPageButton.rst.txt b/Documentation/ContentMapping/_images/PreviewPageButton.rst.txt deleted file mode 100644 index 50c5c7d7..00000000 --- a/Documentation/ContentMapping/_images/PreviewPageButton.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/PreviewPageButton.png - :class: with-shadow - :caption: View webpage button - - View webpage button diff --git a/Documentation/ContentMapping/_images/SaveAndCloseRegularTextElement.rst.txt b/Documentation/ContentMapping/_images/SaveAndCloseRegularTextElement.rst.txt deleted file mode 100644 index 880750e1..00000000 --- a/Documentation/ContentMapping/_images/SaveAndCloseRegularTextElement.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/SaveAndCloseRegularTextElement.png - :class: with-shadow - :caption: Save and close the new content element - - Save and close the new content element diff --git a/Documentation/ContentMapping/_images/SwitchBackendLayoutForSubpages.rst.txt b/Documentation/ContentMapping/_images/SwitchBackendLayoutForSubpages.rst.txt deleted file mode 100644 index 27d4e25f..00000000 --- a/Documentation/ContentMapping/_images/SwitchBackendLayoutForSubpages.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/SwitchBackendLayoutForSubpages.png - :class: with-shadow - :caption: Switch to the Backend Layout "Two Columns" for subpages - - Switch to the Backend Layout "Two Columns" for subpages diff --git a/Documentation/ContentMapping/_images/TwoColumnsPreviewPage.rst.txt b/Documentation/ContentMapping/_images/TwoColumnsPreviewPage.rst.txt deleted file mode 100644 index 63f11ef7..00000000 --- a/Documentation/ContentMapping/_images/TwoColumnsPreviewPage.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/TwoColumnsPreviewPage.png - :class: with-shadow - :caption: The sidebar appears in the frontend - - The sidebar appears in the frontend diff --git a/Documentation/ContentMapping/_images/VerifyPageContent.rst.txt b/Documentation/ContentMapping/_images/VerifyPageContent.rst.txt deleted file mode 100644 index 8996fc35..00000000 --- a/Documentation/ContentMapping/_images/VerifyPageContent.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ -.. figure:: /ContentMapping/_images/VerifyPageContent.png - :class: with-shadow - :caption: Verify if your new content is displayed on the page - - Verify if your new content is displayed on the page diff --git a/Documentation/FluidTemplates/Index.rst b/Documentation/FluidTemplates/Index.rst index 5090d9e8..64b4709f 100644 --- a/Documentation/FluidTemplates/Index.rst +++ b/Documentation/FluidTemplates/Index.rst @@ -151,7 +151,7 @@ You should now have the following files: :level: 3 :show-file-icons: true - * EXT:my_site_package/Resources/Private/PageView + * packages/my_site_package/Resources/Private/PageView * Pages @@ -182,7 +182,7 @@ the partial :file:`Resources/Private/PageView/Partials/Header.html` to its own partial, :file:`Resources/Private/PageView/Partials/Navigation/Menu.html`: .. literalinclude:: _codesnippets/_remove_menu_from_header.diff - :caption: EXT:my_site_package/Resources/Private/PageView/Partials/Header.html (Difference) + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Header.html (Difference) The :ref:`Render ViewHelper ` is used the same like from within the template. @@ -200,7 +200,7 @@ the partial :file:`Resources/Private/PageView/Partials/Footer.html` to its own partial, :file:`Resources/Private/PageView/Partials/Navigation/FooterMenu.html`: .. literalinclude:: _codesnippets/_remove_menu_from_footer.diff - :caption: EXT:my_site_package/Resources/Private/PageView/Partials/Footer.html (Difference) + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Footer.html (Difference) The footer menu partial looks like this: @@ -272,7 +272,9 @@ Save the extracted layout to a file called :file:`Resources/Private/PageView/Layouts/Layout.html`. This file now contains the following: -.. include:: /CodeSnippets/Fluid/Layout.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/PageView/Layouts/PageLayout.html + :caption: packages/my_site_package/Resources/Private/PageView/Layouts/PageLayout.html + :linenos: Repeat the same for file :file:`Resources/Private/PageView/Pages/Default.html`. @@ -280,7 +282,7 @@ Repeat the same for file :file:`Resources/Private/PageView/Pages/Default.html`. :level: 3 :show-file-icons: true - * EXT:my_sitepackage/Resources/Private/PageView + * packages/my_site_package/Resources/Private/PageView * Layouts diff --git a/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.png b/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.png deleted file mode 100644 index 65f7938c..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.rst.txt b/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.rst.txt deleted file mode 100644 index f63f93eb..00000000 --- a/Documentation/Images/AutomaticScreenshots/BackendLayoutTwoColumns.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/BackendLayoutTwoColumns.png - :class: with-shadow - - A new column "Sidebar" appears diff --git a/Documentation/Images/AutomaticScreenshots/ChooseBackendLayout.rst.txt b/Documentation/Images/AutomaticScreenshots/ChooseBackendLayout.rst.txt deleted file mode 100644 index 96a5d56f..00000000 --- a/Documentation/Images/AutomaticScreenshots/ChooseBackendLayout.rst.txt +++ /dev/null @@ -1,4 +0,0 @@ -.. figure:: /Images/AutomaticScreenshots/ChooseBackendLayout.png - :class: with-shadow - - Choose the backend layout diff --git a/Documentation/Images/AutomaticScreenshots/CreateNewContentElement.rst.txt b/Documentation/Images/AutomaticScreenshots/CreateNewContentElement.rst.txt deleted file mode 100644 index f9e385c7..00000000 --- a/Documentation/Images/AutomaticScreenshots/CreateNewContentElement.rst.txt +++ /dev/null @@ -1,4 +0,0 @@ -.. figure:: /Images/AutomaticScreenshots/CreateNewContentElement.png - :class: with-shadow - - Create new content element diff --git a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.png b/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.png deleted file mode 100644 index 73721738..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.rst.txt b/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.rst.txt deleted file mode 100644 index 593b6434..00000000 --- a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig1.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/CreateSiteConfig1.png - :class: with-shadow - - Create the site configuration \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.png b/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.png deleted file mode 100644 index 3394b5cd..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.rst.txt b/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.rst.txt deleted file mode 100644 index 63161560..00000000 --- a/Documentation/Images/AutomaticScreenshots/CreateSiteConfig2.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/CreateSiteConfig2.png - :class: with-shadow - - Create the site configuration \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.png b/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.png deleted file mode 100644 index 4a98fe79..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.rst.txt b/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.rst.txt deleted file mode 100644 index 88276efc..00000000 --- a/Documentation/Images/AutomaticScreenshots/EditTemplateRecord.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/EditTemplateRecord.png - :class: with-shadow - - Edit the whole template record \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/FillNewContentElement.png b/Documentation/Images/AutomaticScreenshots/FillNewContentElement.png deleted file mode 100644 index f72cb284..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/FillNewContentElement.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/FillNewContentElement.rst.txt b/Documentation/Images/AutomaticScreenshots/FillNewContentElement.rst.txt deleted file mode 100644 index df91ef2b..00000000 --- a/Documentation/Images/AutomaticScreenshots/FillNewContentElement.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/FillNewContentElement.png - :class: with-shadow - - Fill some content in the new content element \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/FilledColumns.png b/Documentation/Images/AutomaticScreenshots/FilledColumns.png deleted file mode 100644 index 31f1019a..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/FilledColumns.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/FilledColumns.rst.txt b/Documentation/Images/AutomaticScreenshots/FilledColumns.rst.txt deleted file mode 100644 index f63bab68..00000000 --- a/Documentation/Images/AutomaticScreenshots/FilledColumns.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/FilledColumns.png - :class: with-shadow - - The columns with their Content \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/FlushAllCaches.rst.txt b/Documentation/Images/AutomaticScreenshots/FlushAllCaches.rst.txt deleted file mode 100644 index d2e6dd49..00000000 --- a/Documentation/Images/AutomaticScreenshots/FlushAllCaches.rst.txt +++ /dev/null @@ -1,4 +0,0 @@ -.. figure:: /Images/AutomaticScreenshots/FlushAllCaches.png - :class: with-shadow - - Flush all caches diff --git a/Documentation/Images/AutomaticScreenshots/FlushFrontendCaches.rst.txt b/Documentation/Images/AutomaticScreenshots/FlushFrontendCaches.rst.txt deleted file mode 100644 index a56ffe7e..00000000 --- a/Documentation/Images/AutomaticScreenshots/FlushFrontendCaches.rst.txt +++ /dev/null @@ -1,5 +0,0 @@ - -.. figure:: /Images/AutomaticScreenshots/FlushFrontendCaches.png - :class: with-shadow - - Flush the frontend cache after changing template files diff --git a/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.png b/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.png deleted file mode 100644 index 1a2e3dad..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.rst.txt b/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.rst.txt deleted file mode 100644 index f796f264..00000000 --- a/Documentation/Images/AutomaticScreenshots/IncludeTsConfig.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/IncludeTsConfig.png - :class: with-shadow - - Include the site package page TsConfig \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.png b/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.png deleted file mode 100644 index b7ef889d..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.rst.txt b/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.rst.txt deleted file mode 100644 index 28fa5886..00000000 --- a/Documentation/Images/AutomaticScreenshots/IncludeTypoScriptTemplate.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/IncludeTypoScriptTemplate.png - :class: with-shadow - - Include the site package TypoScript template \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.png b/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.png deleted file mode 100644 index 509feea9..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.rst.txt b/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.rst.txt deleted file mode 100644 index 9f62d7f6..00000000 --- a/Documentation/Images/AutomaticScreenshots/SwitchBackendLayout.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/SwitchBackendLayout.png - :class: with-shadow - - Switch to the Backend Layout "Two Columns" \ No newline at end of file diff --git a/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.png b/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.png deleted file mode 100644 index c50b47d2..00000000 Binary files a/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.png and /dev/null differ diff --git a/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.rst.txt b/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.rst.txt deleted file mode 100644 index 009b46ac..00000000 --- a/Documentation/Images/AutomaticScreenshots/TwoColumnsPreviewPage.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ -.. Automatic screenshot: Remove this line if you want to manually change this file - -.. figure:: /Images/AutomaticScreenshots/TwoColumnsPreviewPage.png - :class: with-shadow - - The sidebar appears in the frontend \ No newline at end of file diff --git a/Documentation/ContentMapping/_images/AddNewContentElement.png b/Documentation/Images/ContentMapping/AddNewContentElement.png similarity index 100% rename from Documentation/ContentMapping/_images/AddNewContentElement.png rename to Documentation/Images/ContentMapping/AddNewContentElement.png diff --git a/Documentation/ContentMapping/_images/BackendLayoutTwoColumns.png b/Documentation/Images/ContentMapping/BackendLayoutTwoColumns.png similarity index 100% rename from Documentation/ContentMapping/_images/BackendLayoutTwoColumns.png rename to Documentation/Images/ContentMapping/BackendLayoutTwoColumns.png diff --git a/Documentation/ContentMapping/_images/ChooseRegularTextElement.png b/Documentation/Images/ContentMapping/ChooseRegularTextElement.png similarity index 100% rename from Documentation/ContentMapping/_images/ChooseRegularTextElement.png rename to Documentation/Images/ContentMapping/ChooseRegularTextElement.png diff --git a/Documentation/ContentMapping/_images/EditRegularTextElement1.png b/Documentation/Images/ContentMapping/EditRegularTextElement1.png similarity index 100% rename from Documentation/ContentMapping/_images/EditRegularTextElement1.png rename to Documentation/Images/ContentMapping/EditRegularTextElement1.png diff --git a/Documentation/ContentMapping/_images/EditRegularTextElement2.png b/Documentation/Images/ContentMapping/EditRegularTextElement2.png similarity index 100% rename from Documentation/ContentMapping/_images/EditRegularTextElement2.png rename to Documentation/Images/ContentMapping/EditRegularTextElement2.png diff --git a/Documentation/ContentMapping/_images/PreviewPageButton.png b/Documentation/Images/ContentMapping/PreviewPageButton.png similarity index 100% rename from Documentation/ContentMapping/_images/PreviewPageButton.png rename to Documentation/Images/ContentMapping/PreviewPageButton.png diff --git a/Documentation/ContentMapping/_images/SaveAndCloseRegularTextElement.png b/Documentation/Images/ContentMapping/SaveAndCloseRegularTextElement.png similarity index 100% rename from Documentation/ContentMapping/_images/SaveAndCloseRegularTextElement.png rename to Documentation/Images/ContentMapping/SaveAndCloseRegularTextElement.png diff --git a/Documentation/ContentMapping/_images/SwitchBackendLayoutForSubpages.png b/Documentation/Images/ContentMapping/SwitchBackendLayoutForSubpages.png similarity index 100% rename from Documentation/ContentMapping/_images/SwitchBackendLayoutForSubpages.png rename to Documentation/Images/ContentMapping/SwitchBackendLayoutForSubpages.png diff --git a/Documentation/ContentMapping/_images/TwoColumnsPreviewPage.png b/Documentation/Images/ContentMapping/TwoColumnsPreviewPage.png similarity index 100% rename from Documentation/ContentMapping/_images/TwoColumnsPreviewPage.png rename to Documentation/Images/ContentMapping/TwoColumnsPreviewPage.png diff --git a/Documentation/ContentMapping/_images/VerifyPageContent.png b/Documentation/Images/ContentMapping/VerifyPageContent.png similarity index 100% rename from Documentation/ContentMapping/_images/VerifyPageContent.png rename to Documentation/Images/ContentMapping/VerifyPageContent.png diff --git a/Documentation/ContentMapping/_images/contents_debug.png b/Documentation/Images/ContentMapping/contents_debug.png similarity index 100% rename from Documentation/ContentMapping/_images/contents_debug.png rename to Documentation/Images/ContentMapping/contents_debug.png diff --git a/Documentation/MainMenuCreation/_images/CheckMainMenu.png b/Documentation/Images/MainMenuCreation/CheckMainMenu.png similarity index 100% rename from Documentation/MainMenuCreation/_images/CheckMainMenu.png rename to Documentation/Images/MainMenuCreation/CheckMainMenu.png diff --git a/Documentation/MainMenuCreation/Index.rst b/Documentation/MainMenuCreation/Index.rst index e9ca5ab8..95762266 100644 --- a/Documentation/MainMenuCreation/Index.rst +++ b/Documentation/MainMenuCreation/Index.rst @@ -25,7 +25,8 @@ provide the data of all pages in your current site to your page template. We save the TypoScript configuration for the menu into file :file:`Configuration/Set/SitePackage/TypoScript/Navigation/menu.typoscript`: -.. include:: /CodeSnippets/TypoScript/menu.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript + :caption: packages/my_site_package/Configuration/Sets/SitePackage/TypoScript/Navigation/menu.typoscript .. _fluid-implement-main-menu: @@ -43,7 +44,9 @@ A menu usually contains several menu entries. We use the :ref:`t3viewhelper:typo3fluid-fluid-for` to iterate over all menu entries and render them in turn: -.. include:: /CodeSnippets/Fluid/Menu.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html + :linenos: In each loop the current menu item is stored in variable `{menuItem}`. @@ -51,7 +54,7 @@ You can use the :ref:`t3viewhelper:typo3-fluid-debug` to debug what kind of data the variable contains like this: .. code-block:: diff - :caption: EXT:site_package/Resources/Private/PageView/Partials/Navigation/Menu.html (changed for debug output) + :caption: packages/my_site_package/Resources/Private/PageView/Partials/Navigation/Menu.html (changed for debug output)
    @@ -108,12 +111,19 @@ working as expected and if the menu is generated. Go to **WEB → View** and check, if the menu reflects the pages you created in the backend. Add one or two additional pages to the page tree and check to see if they appear in the preview. -.. include:: _images/CheckMainMenu.rst.txt +.. figure:: /Images/MainMenuCreation/CheckMainMenu.png + :alt: Checking from the backend if the menu is generated as expected. + :class: with-shadow + + Checking from the backend if the menu is generated as expected. If the menu does not change, you possibly need to flush the frontend caches, then reload the preview. -.. include:: /Images/AutomaticScreenshots/FlushFrontendCaches.rst.txt +.. figure:: /Images/AutomaticScreenshots/FlushFrontendCaches.png + :class: with-shadow + + Flush the frontend cache after changing template files The preview in the screenshot above shows the menu with three page links: "Page 1", "Page 2" and "Page 3". diff --git a/Documentation/MainMenuCreation/_images/CheckMainMenu.rst.txt b/Documentation/MainMenuCreation/_images/CheckMainMenu.rst.txt deleted file mode 100644 index b99ec827..00000000 --- a/Documentation/MainMenuCreation/_images/CheckMainMenu.rst.txt +++ /dev/null @@ -1,6 +0,0 @@ - -.. figure:: /MainMenuCreation/_images/CheckMainMenu.png - :caption: Checking from the backend if the menu is generated as expected. - :class: with-shadow - - Checking from the backend if the menu is generated as expected. diff --git a/Documentation/MinimalExample/Index.rst b/Documentation/MinimalExample/Index.rst index b1b93393..40085473 100644 --- a/Documentation/MinimalExample/Index.rst +++ b/Documentation/MinimalExample/Index.rst @@ -57,7 +57,7 @@ needs to be :ref:`installed `: `my_site_package` is the extension name. For historical reasons all dashes need to be converted to underscores and the vendor name removed. This name is used - to reference files, for example `EXT:my_site_package/Resources/Public/Css/my.css`. + to reference files, for example `packages/my_site_package/Resources/Public/Css/my.css`. .. _minimal-b13-make-extension: @@ -361,7 +361,10 @@ Whenever we have made changes to the Fluid templates or TypoScript files, it is necessary to :guilabel:`Flush frontend caches` in the menu in the top bar before you can preview the page properly: -.. include:: /Images/AutomaticScreenshots/FlushFrontendCaches.rst.txt +.. figure:: /Images/AutomaticScreenshots/FlushFrontendCaches.png + :class: with-shadow + + Flush the frontend cache after changing template files You can then preview your page by clicking on the button :guilabel:`View webpage` in the page module. @@ -374,7 +377,9 @@ Composer configuration :file:`composer.json` In step :ref:`Create a minimal TYPO3 extension ` a file called :file:`composer.json` was created for you: -.. include:: /CodeSnippets/ExtensionConfiguration/ComposerJson.rst.txt +.. literalinclude:: /CodeSnippets/my_site_package/composer.json + :caption: packages/my_site_package/composer.json + :linenos: At the top of the :file:`composer.json` file we see the Composer package name `myvendor/my-site-package` (with a dash) and at the bottom we see the TYPO3 diff --git a/Documentation/SiteSets/Index.rst b/Documentation/SiteSets/Index.rst index 7c115394..9fabe6ea 100644 --- a/Documentation/SiteSets/Index.rst +++ b/Documentation/SiteSets/Index.rst @@ -40,8 +40,8 @@ to the site sets of :composer:`typo3/cms-fluid-styled-content`. Your site set configuration should now look like this: -.. literalinclude:: /CodeSnippets/ExtensionConfiguration/SitePackage-config.yaml - :caption: EXT:my_site_package/Configuration/Sets/SitePackage/config.yaml +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/config.yaml + :caption: packages/my_site_package/Configuration/Sets/SitePackage/config.yaml :language: yaml :linenos: @@ -78,8 +78,8 @@ We override some default settings of the site set :ref:`Site set "Fluid Styled Content" `: -.. literalinclude:: /CodeSnippets/ExtensionConfiguration/SitePackage-settings.yaml - :caption: EXT:my_site_package/Configuration/Sets/SitePackage/settings.yaml +.. literalinclude:: /CodeSnippets/my_site_package/Configuration/Sets/SitePackage/settings.yaml + :caption: packages/my_site_package/Configuration/Sets/SitePackage/settings.yaml :language: yaml :linenos: diff --git a/Makefile b/Makefile index 38c5883c..6063c896 100644 --- a/Makefile +++ b/Makefile @@ -5,7 +5,7 @@ help: ## Displays this list of targets with descriptions .PHONY: codesnippets codesnippets: ## Regenerate automatic code snippets - .Build/vendor/bin/typo3 codesnippet:create Documentation/CodeSnippets/ + ./Build/DownloadSitePackage/generate_sitepackage.sh .PHONY: docs docs: ## Generate projects docs (from "Documentation" directory)