.. include:: Includes.txt

.. _start:

===========================================
TYPO3ドキュメントへようこそ
===========================================

TYPO3 CMSはPHPを利用したオープンソースのエンタープライズコンテンツ管理システムです。

.. rst-class:: horizbuttons-primary-m

- :ref:`tutorials`
- :ref:`references`
- :ref:`extensions`

__________________________________________________

.. _start-getting-stared:

はじめに
===============

TYPO3の異なるバージョンとシステム要件の詳細については、 https://get.typo3.org を参照してください。

TYPO3をインストールするには、 :ref:`Composerのクイックインストールガイド <t3install:install-via-composer>` に従ってください。

.. code-block:: bash

   composer create-project typo3/cms-base-distribution YourNewProjectFolder

バックエンドで :ref:`サイトの設定 <sitehandling-basics>` を行い、ドメイン、言語、URL、エラーページを設定します。

The :ref:`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.

その他のチュートリアルを :ref:`tutorials` で探す。
サポートを依頼するには、StackOverflowやSlackを利用します。
詳細は `help page <https://typo3.org/help>`__ をご覧ください。


.. _how-the-documentation-is-organized:

ドキュメントはどのように構成されているか
============================================

* :ref:`tutorials` は、編集者、インテグレータ、開発者のためのドキュメントを含む、TYPO3の新規および既存のユーザーのためのリソースの包括的なリストを含んでいます。
* :ref:`references` は、TYPO3のコアに関する詳細な情報を提供し、インテグレータと開発者を対象としています。
* :ref:`System-Extensions` provide a list of all extensions currently used in TYPO3's core along with documentation for each of the extensions listed.
* :ref:`extensions` allow you to search for documentation that has been provided for third party extensions.

.. _start-theme:

テーマを作成する
====================

*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:

* `Concept of Sitepackages <https://www.slideshare.net/benjaminkott/typo3-the-anatomy-of-sitepackages>`__
* :ref:`t3sitepackage:start`

More introductions:

* The `Fluid documentation <https://github.com/TYPO3/Fluid>`__
  contains information about Fluid. As it is an independent project, the documentation is not
  maintained on docs.typo3.org.
* The system extension :ref:`fluid_styled_content <fsc:start>` handles the rendering of the default
  set of content elements shipped with the core by using the template engine
  `Fluid <https://typo3.org/fluid>`__
* :ref:`Backend layouts <t3coreapi:be-layout>`
* :ref:`Create custom content elements <t3coreapi:adding-your-own-content-elements>`

References

* :ref:`t3tsref:start`
* :ref:`t3viewhelper:start`


.. _start-extdev:

カスタムエクステンションの開発
====================================

:ref:`references` lists all relevant core manuals. One of these is
:ref:`t3coreapi:start`. It contains detailed information for core and extension developers,

Getting started with extension development:

* :ref:`Introduction to extensions in TYPO3 <t3coreapi:extension-architecture-introduction>`
* Extension :ref:`t3coreapi:extension-files-locations`
* :ref:`t3coreapi:extension-naming` and :ref:`t3coreapi:cgl`

More topics can be found in :ref:`t3coreapi:start`, for example:

* :ref:`QueryBuilder <t3coreapi:database-query-builder>` based on
  Doctrine
* :ref:`t3coreapi:DependencyInjection`
* :ref:`t3coreapi:request-handling`

If you are updating TYPO3 to the next major version, you may need to make changes
in your custom extensions.

The `Core changelog <https://docs.typo3.org/c/typo3/cms-core/master/en-us/>`__ lists
all relevant changes for each TYPO3 version since 7.



.. _start-configuration:

TYPO3の設定
===============

One of the major features of TYPO3 is its configurability. The :ref:`t3coreapi:config-overview`
in "TYPO3 Explained" gives you an overview of various configuration languages.

Specifically, you might want to

* Set up the :ref:`site configuration <sitehandling-basics>` in the backend to configure
  the domain, languages, URLs and error pages.
* Configure :ref:`rte_ckeditor <ckeditor:configuration>`
  to enhance the editing experience when handling rich text editing.
* :ref:`Configure the form system extension <form:quickstartIntegrators>` to create
  custom forms for the frontend.
* :ref:`Configure backend users <t3start:user-management>`


.. _start-localization:

翻訳の作成方法
==========================

*国際化* | *翻訳* | *複数の言語*

* :ref:`Supported languages <t3coreapi:i18n_languages>`
* :ref:`Manage backend languages <t3start:changing-backend-language>`
* :ref:`エディターとして言語を扱う <t3editors:languages>`
* :ref:`t3coreapi:internationalization` in "TYPO3 Explained"

__________________________________________________

.. _start-coredev:

コアに貢献する
======================

「コア投稿ガイド」には、コアパッチを作成するための情報が記載されています:

* :ref:`Create a patch <t3contribute:quickstart-create-a-patch>`
* :ref:`Commit message rules <t3contribute:commitmessage>`
* :ref:`Setup an installation with DDEV <t3contribute:ddev>`

But contributions aren't just about writing patches. You can contribute
in numerous other ways, including

* :ref:`Writing issues <t3contribute:forge-index>`
* :ref:`Review patches <t3contribute:improving-a-patch>`



.. _start-contribute-docs:

公式文書への貢献
====================================

どのページでも「Edit on GitHub」ボタンをクリックして、改善できそうなことがあれば公式ドキュメントの変更を提案してください。

* The blog post `Start Improving Docs Now to Grow TYPO3 <https://typo3.com/blog/start-improving-docs-now-to-grow-typo3>`__
  gives a good introduction to documentation contribution.
* :ref:`h2document:docs-contribute` explains the workflow for contributing.
* The documentation is edited in text files using reStructuredText syntax.
  Use the :ref:`rest-cheat-sheet` to lookup most commonly used directives.
* General conventions can be found in :ref:`h2document:conventions`
* :ref:`h2document:docs-official-how-you-can-help` lists some general tasks
  to get you started.

.. toctree::
   :hidden:

   はじめに <https://docs.typo3.jp/#gettting-started>
   Home/GuidesAndTutorials
   Home/References
   Home/Extensions
   Home/WhatsNew
   Cheat Sheets                     <https://docs.typo3.org/m/typo3/docs-cheatsheets/master/en-us/>
   Tell Me Something About Topic X  <https://docs.typo3.org/typo3cms/TellMeSomethingAbout/>
   Snippets                         <https://docs.typo3.org/typo3cms/Snippets/>
   Home/About/Index
   Home/Contribute