TYPO3ドキュメントへようこそ¶
TYPO3 CMSはPHPを利用したオープンソースのエンタープライズコンテンツ管理システムです。
はじめに¶
TYPO3の異なるバージョンとシステム要件の詳細については、 https://get.typo3.org を参照してください。
TYPO3をインストールするには、 Composerのクイックインストールガイド に従ってください。
composer create-project typo3/cms-base-distribution YourNewProjectFolder
バックエンドで サイトの設定 を行い、ドメイン、言語、URL、エラーページを設定します。
The t3start:start walks you through the backend - the interface for editing content and configuring the TYPO3 installation. You need a browser and a working TYPO3 installation.
その他のチュートリアルを チュートリアルとガイド で探す。 サポートを依頼するには、StackOverflowやSlackを利用します。 詳細は help page をご覧ください。
ドキュメントはどのように構成されているか¶
- チュートリアルとガイド は、編集者、インテグレータ、開発者のためのドキュメントを含む、TYPO3の新規および既存のユーザーのためのリソースの包括的なリストを含んでいます。
- コアドキュメント は、TYPO3のコアに関する詳細な情報を提供し、インテグレータと開発者を対象としています。
- System Extensions provide a list of all extensions currently used in TYPO3's core along with documentation for each of the extensions listed.
- エクステンションキーによるエクステンション allow you to search for documentation that has been provided for third party extensions.
テーマを作成する¶
Theme | Templating | Sitepackage
It is considered good practice to create a Sitepackage. This is an extension which contains the resources required for a theme.
Sitepackage:
More introductions:
- The Fluid documentation contains information about Fluid. As it is an independent project, the documentation is not maintained on docs.typo3.org.
- The system extension fluid_styled_content handles the rendering of the default set of content elements shipped with the core by using the template engine Fluid
- Backend layouts
- Create custom content elements
References
- TypoScript Template Reference
- t3viewhelper:start
カスタムエクステンションの開発¶
コアドキュメント lists all relevant core manuals. One of these is TYPO3の説明. It contains detailed information for core and extension developers,
Getting started with extension development:
- Introduction to extensions in TYPO3
- Extension Files and Locations
- Naming Conventions and Coding Guidelines
More topics can be found in TYPO3の説明, for example:
- QueryBuilder based on Doctrine
- Dependency Injection
- Request Handling (Middlewares)
If you are updating TYPO3 to the next major version, you may need to make changes in your custom extensions.
The Core changelog lists all relevant changes for each TYPO3 version since 7.
TYPO3の設定¶
One of the major features of TYPO3 is its configurability. The Configuration in "TYPO3 Explained" gives you an overview of various configuration languages.
Specifically, you might want to
- Set up the site configuration in the backend to configure the domain, languages, URLs and error pages.
- Configure rte_ckeditor to enhance the editing experience when handling rich text editing.
- Configure the form system extension to create custom forms for the frontend.
- Configure backend users
翻訳の作成方法¶
国際化 | 翻訳 | 複数の言語
- Supported languages
- Manage backend languages
- エディターとして言語を扱う
- Internationalization and Localization in "TYPO3 Explained"
コアに貢献する¶
「コア投稿ガイド」には、コアパッチを作成するための情報が記載されています:
- Create a patch
- Commit message rules
- Setup an installation with DDEV
But contributions aren't just about writing patches. You can contribute in numerous other ways, including
- Writing issues
- Review patches
公式文書への貢献¶
どのページでも「Edit on GitHub」ボタンをクリックして、改善できそうなことがあれば公式ドキュメントの変更を提案してください。
- The blog post Start Improving Docs Now to Grow TYPO3 gives a good introduction to documentation contribution.
- How to Contribute to Official Documentation explains the workflow for contributing.
- The documentation is edited in text files using reStructuredText syntax. Use the reST & Sphinx Cheat Sheet to lookup most commonly used directives.
- General conventions can be found in Documentation content style guide
- How You Can Help lists some general tasks to get you started.