Warning
This tutorial assumes you are using at least TYPO3 v13.1. If you want to use the current LTS (long time support) version 12.4 of TYPO3, switch to the Site package tutorial for TYPO3 12.4.
Minimal example¶
We want to create a site package that outputs a single web page with minimal effort. This site package can be used to simply test system output or as an example of the fewest possible steps to create a working site package.
To start, in the TYPO3 backend, create a standard page named Minimal example just under (inside) the page tree TYPO3 logo container. Create a new TypoScript template record on this page. Give the TypoScript template a title, and make it a root level template, but do not include any static templates.
The TypoScript-only version¶
In the TypoScript template Setup field, add the following three lines:
page = PAGE
page.1 = TEXT
page.1.value = Hello, world.
View the web page.
This TypoScript-only design has the least instructions required to output a web page from TYPO3. This TypoScript template is self contained and no other files or database records needed. Changing this content only requires the appropriate access needed to make changes to TypoScript templates.
The TYPO3 Fluid version¶
Empty the Minimal design page TypoScript template Setup field, then add the following lines:
page = PAGE
page.1 = FLUIDTEMPLATE
page.1.file = EXT:site_package/Resources/Private/Templates/Minimal.html
Create a file named Minimal.
in a
typo3conf/
folder.
The site package extension has to be installed and requires a minimal composer configuration (if composer is used) for this to work
Hello, world.
Now view the web page.
Here we are putting the page content into a separate HTML file, allowing for separate access control and for an editing workflow that does not need much TypoScript. The TYPO3 renderer still requires a TypoScript template on the Minimal design page to know which file to process.
Resulting web page¶
Here is the resulting web page HTML source for both the TypoScript-only and the Fluid based implementations. Notice how TYPO3 has added default markup around the single line of content:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<!--
This website is powered by TYPO3 - inspiring people to share!
TYPO3 is a free open source Content Management Framework initially
created by Kasper Skaarhoj and licensed under GNU/GPL.
TYPO3 is copyright 1998-2018 of Kasper Skaarhoj. Extensions are
copyright of their respective owners.
Information and contribution at https://typo3.org/
-->
<title>Minimal design</title>
<meta name="generator" content="TYPO3 CMS">
</head>
<body>
Hello, world.
</body>
</html>