Initial Drupal 11 with DDEV setup
This commit is contained in:
gluebox
@ -0,0 +1,36 @@
|
||||
---
|
||||
label: 'Configuring taxonomy'
|
||||
related:
|
||||
- taxonomy.overview
|
||||
- field_ui.reference_field
|
||||
- field_ui.manage_display
|
||||
- field_ui.manage_form
|
||||
---
|
||||
{% set taxonomy_permissions_link_text %}
|
||||
{% trans %}Administer vocabularies and terms{% endtrans %}
|
||||
{% endset %}
|
||||
{% set taxonomy_permissions_link = render_var(help_route_link(taxonomy_permissions_link_text, 'user.admin_permissions.module', {'modules': 'taxonomy'})) %}
|
||||
{% set taxonomy_admin_link_text %}
|
||||
{% trans %}Taxonomy{% endtrans %}
|
||||
{% endset %}
|
||||
{% set taxonomy_admin_link = render_var(help_route_link(taxonomy_admin_link_text, 'entity.taxonomy_vocabulary.collection')) %}
|
||||
{% set taxonomy_overview_topic = render_var(help_topic_link('taxonomy.overview')) %}
|
||||
{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
|
||||
<h2>{% trans %}Goal{% endtrans %}</h2>
|
||||
<p>{% trans %}Create a taxonomy vocabulary and add a reference field for that vocabulary to a content entity. See {{ taxonomy_overview_topic }} for information about taxonomy and {{ content_structure_topic }} for more on content entities.{% endtrans %}</p>
|
||||
<h2>{% trans %}Who can configure a taxonomy vocabulary?{% endtrans %}</h2>
|
||||
<p>{% trans %}Users with the <em>{{ taxonomy_permissions_link }}</em> permission can configure a vocabulary. To add a field in the administrative interface, the core Field UI module must be installed, and you will also need the <em>Administer fields</em> permission for the entity you are adding the field to.{% endtrans %}</p>
|
||||
<h2>{% trans %}Steps{% endtrans %}</h2>
|
||||
<ol>
|
||||
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <em>{{ taxonomy_admin_link }}</em>.{% endtrans %}</li>
|
||||
<li>{% trans %}Click <em>Add vocabulary</em>.{% endtrans %}</li>
|
||||
<li>{% trans %}In the <em>Name</em> field, enter a name for the vocabulary (for example "Ingredients"), which is how it will be shown in the administrative interface. Optionally, add a description.{% endtrans %}</li>
|
||||
<li>{% trans %}Click <em>Save</em>. Your vocabulary will be created and you will see the page that lists all the terms in this vocabulary.{% endtrans %}</li>
|
||||
<li>{% trans %}Optionally, click <em>Add term</em> to add a term to the new vocabulary. In the <em>Name</em> field, enter the term name (for example "Butter"). Click <em>Save</em>. You will receive a confirmation about the term you created. You may optionally continue to add more terms.{% endtrans %}</li>
|
||||
<li>{% trans %}If you have the Field UI module installed, follow the instructions on the related <em>Adding a reference field to an entity sub-type</em> topic to add a taxonomy reference field to the entity type of your choice. The settings page will allow you to choose the <em>Vocabulary</em> that you created as the vocabulary to reference.{% endtrans %}</li>
|
||||
<li>{% trans %}You may also want to configure the display and form display of the new field (see related topics).{% endtrans %}</li>
|
||||
</ol>
|
||||
<h2>{% trans %}Additional resources{% endtrans %}</h2>
|
||||
<ul>
|
||||
<li><a href="https://www.drupal.org/docs/user_guide/en/structure-taxonomy-setup.html">{% trans %}Setting Up a Taxonomy (Drupal User Guide){% endtrans %}</a></li>
|
||||
</ul>
|
||||
@ -0,0 +1,22 @@
|
||||
---
|
||||
label: 'Managing taxonomy'
|
||||
top_level: true
|
||||
---
|
||||
{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
|
||||
<h2>{% trans %}What is taxonomy?{% endtrans %}</h2>
|
||||
<p>{% trans %}<em>Taxonomy</em> is used to classify website content. One common example of taxonomy is the tags used to classify or categorize posts in a blog website; a cooking website could use an ingredients taxonomy to classify recipes. Individual taxonomy items are known as <em>terms</em> (the blog tags or recipe ingredients in these examples); and a set of terms is known as a <em>vocabulary</em> (the set of all blog post tags, or the set of all recipe ingredients in these examples). Technically, taxonomy terms are an entity type and the entity subtypes are the vocabularies; see {{ content_structure_topic }} for more on content entities. Like other entities, taxonomy terms can have fields attached; for instance, you could set up an image field to contain an icon for each term.{% endtrans %}</p>
|
||||
<p>{% trans %}An individual vocabulary can organize its terms in a hierarchy, or it could be flat. For example, blog tags normally have a flat structure, while a recipe ingredients vocabulary could be hierarchical (for example, tomatoes could be a sub-term of vegetables, and under tomatoes, you could have green and red tomatoes).{% endtrans %}</p>
|
||||
<p>{% trans %}Taxonomy terms are normally attached as reference fields to other content entities, which is how you can use them to classify content. When you set up a taxonomy reference field, you can let users enter terms in two ways:{% endtrans %}</p>
|
||||
<dl>
|
||||
<dt>{% trans %}Free tagging{% endtrans %}</dt>
|
||||
<dd>{% trans %}New terms can be created right on the content editing form.{% endtrans %}</dd>
|
||||
<dt>{% trans %}Fixed list of terms{% endtrans %}</dt>
|
||||
<dd>{% trans %}The list of terms is curated and managed outside the content editing form, and users can only select from the existing list when editing content.{% endtrans %}</dd>
|
||||
</dl>
|
||||
<p>{% trans %}Taxonomy reference fields can be added to any entity, such as user accounts, content blocks, or regular content items. If you use them to classify regular content items, your site will automatically be set up with taxonomy listing pages for each term; each of these pages lists all of the content items that are classified with that term.{% endtrans %}</p>
|
||||
<h2>{% trans %}Overview of managing taxonomy{% endtrans %}</h2>
|
||||
<p>{% trans %}The core Taxonomy module allows you to create and edit taxonomy vocabularies and taxonomy terms. The core Field UI module provides a user interface for adding fields to entities, including the taxonomy reference field, and configuring field editing and display. See the related topics listed below for specific tasks.{% endtrans %}</p>
|
||||
<h2>{% trans %}Additional resources{% endtrans %}</h2>
|
||||
<ul>
|
||||
<li><a href="https://www.drupal.org/docs/user_guide/en/structure-taxonomy.html">{% trans %}Concept: Taxonomy (Drupal User Guide){% endtrans %}</a></li>
|
||||
</ul>
|
||||
Reference in New Issue
Block a user