Skip to content

Commit

Permalink
Enhance wording
Browse files Browse the repository at this point in the history
  • Loading branch information
ksuess committed Jun 12, 2023
1 parent 83fb8ce commit c4106b0
Show file tree
Hide file tree
Showing 20 changed files with 324 additions and 325 deletions.
Binary file modified docs/source/_static/user-manual/manage/link-to-items.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 10 additions & 10 deletions docs/source/user-manual/links-to-item.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,34 +4,34 @@ myst:
"description": "User manual on how to find all links and relations to the current item."
"property=og:description": "User manual on how to find all links and relations to the current item."
"property=og:title": "Finding links and relations to the current item."
"keywords": "Volto, Plone, frontend, React, User manual, links, relations"
"keywords": "Volto, Plone, frontend, React, User manual, links, relations, references, related content"
---

(links-to-item-label)=

# Finding links and relations to the current item
# Finding links and references to the current page

Sometimes it can be hard to keep track from where a certain page is referenced.
This is especially true whenever you want to reconstruct your website with a greater number of objects being moved or deleted.
For this situation, you can visit the {guilabel}`Links to item` page, which is an overview of all objects that refererence a certain object.
For this situation, you can visit the {guilabel}`Links and references` page, which is an overview of all content items that refererence a certain content item.

```{note}
An item references another item by creating a hyperlink to this item, using the item in a block, referencing it in the {guilabel}`Related Items` field, or referencing it in a relation field.
```

## {guilabel}`Links to item` view
## {guilabel}`Links and references` view

In the toolbar on the left side, you can click on the item with the three horizontally aligned dots, called {guilabel}`More menu`.
Click then on the item labeled {guilabel}`Links to item`.
Click then on the item labeled {guilabel}`Links and references`.

You can see now a table displaying all links to the current item.
You can see now a table displaying all links and references to the current item.

```{image} ../_static/user-manual/manage/link-to-items.png
:alt: A panel captioned with "Links to My Summer Vacation - Day 2". A table with two columns (first column labeled with "Linking this item", second column labeled with "review state"). In the row appears a link titled "Links to My Summer Vacation - Day 1", because it is referencing the current item.
:alt: A panel captioned with "Links and references to 'My Summer Vacation - Day 2'". A table with three columns (first column labeled with "Linking / referencing this item", second column labeled with "Review state", third column labeled with "Type"). In the row appears a link titled "Links to My Summer Vacation - Day 1", because it is referencing the current item.
```

For editors, this view gives insight to whether those links are still relevant.
On second sight, it also helps to prevent potential broken links.
For editors, this view gives insight to whether those links and references are still relevant.
On second sight, it also helps to prevent potential broken links and relations.

For example, when you try to delete this page with other pages linking to it, you will get a warning that this will cause broken links that lead to a "not found" error page.
For example, when you try to delete this page with other pages linking to it, you will get a warning that this will cause broken links or relations that lead to a "not found" error page.
If you receive such a warning, you can inspect this view and go through each referencing page, removing any references.
32 changes: 16 additions & 16 deletions locales/ca/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -746,8 +746,8 @@ msgid "Content rules from parent folders"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
# defaultMessage: Content that links or references to {title}
msgid "Content that links or references to {title}"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
Expand Down Expand Up @@ -1920,19 +1920,14 @@ msgid "Link translation for"
msgstr "Traducció d'enllaços per"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
# defaultMessage: Linking this item with hyperlink in text
msgid "Linking this item with hyperlink in text"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
# defaultMessage: Links and references
msgid "Links and references"
msgstr ""

#: components/manage/Blocks/Listing/schema
Expand Down Expand Up @@ -2645,6 +2640,16 @@ msgstr ""
msgid "Reduce complexity"
msgstr "Disseny de taula minimalista"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item as related item
msgid "Referencing this item as related item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item with {relationship}
msgid "Referencing this item with {relationship}"
msgstr ""

#: components/theme/Anontools/Anontools
#: components/theme/Login/Login
#: components/theme/Register/Register
Expand Down Expand Up @@ -4327,11 +4332,6 @@ msgstr "Heroi"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
38 changes: 19 additions & 19 deletions locales/de/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -743,9 +743,9 @@ msgid "Content rules from parent folders"
msgstr "Inhaltsregeln von übergeordneten Seiten"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
msgstr "Alle Inhalte, die auf dieses Item verlinken"
# defaultMessage: Content that links or references to {title}
msgid "Content that links or references to {title}"
msgstr "Zu {title} verlinkende oder referenzierende Inhalte"

#: components/manage/Controlpanels/ContentTypes
# defaultMessage: Content type created
Expand Down Expand Up @@ -1917,20 +1917,15 @@ msgid "Link translation for"
msgstr "Übersetzung verbinden"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
msgstr "Inhalte, die hierher verlinken"
# defaultMessage: Linking this item with hyperlink in text
msgid "Linking this item with hyperlink in text"
msgstr "Inhalte, die im Text auf diesen Inhalt verlinken"

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr "Verlinkende Inhalte"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
msgstr "Zu {title} verlinkende Inhalte"
# defaultMessage: Links and references
msgid "Links and references"
msgstr "Links und Referenzen"

#: components/manage/Blocks/Listing/schema
# defaultMessage: Listing
Expand Down Expand Up @@ -2642,6 +2637,16 @@ msgstr "Wiederholen"
msgid "Reduce complexity"
msgstr "Komplexität reduzieren"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item as related item
msgid "Referencing this item as related item"
msgstr "Inhalte, die diesen Inhalt als verwandten Inhalt referenzieren"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item with {relationship}
msgid "Referencing this item with {relationship}"
msgstr "Inhalte, die diesen Inhalt mit {relationship} referenzieren"

#: components/theme/Anontools/Anontools
#: components/theme/Login/Login
#: components/theme/Register/Register
Expand Down Expand Up @@ -4324,11 +4329,6 @@ msgstr "Hero"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
32 changes: 16 additions & 16 deletions locales/en/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -737,8 +737,8 @@ msgid "Content rules from parent folders"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
# defaultMessage: Content that links or references to {title}
msgid "Content that links or references to {title}"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
Expand Down Expand Up @@ -1911,19 +1911,14 @@ msgid "Link translation for"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
# defaultMessage: Linking this item with hyperlink in text
msgid "Linking this item with hyperlink in text"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
# defaultMessage: Links and references
msgid "Links and references"
msgstr ""

#: components/manage/Blocks/Listing/schema
Expand Down Expand Up @@ -2636,6 +2631,16 @@ msgstr ""
msgid "Reduce complexity"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item as related item
msgid "Referencing this item as related item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item with {relationship}
msgid "Referencing this item with {relationship}"
msgstr ""

#: components/theme/Anontools/Anontools
#: components/theme/Login/Login
#: components/theme/Register/Register
Expand Down Expand Up @@ -4318,11 +4323,6 @@ msgstr ""
msgid "html"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
32 changes: 16 additions & 16 deletions locales/es/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -748,8 +748,8 @@ msgid "Content rules from parent folders"
msgstr "Reglas de contenido de las carpetas principales"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
# defaultMessage: Content that links or references to {title}
msgid "Content that links or references to {title}"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
Expand Down Expand Up @@ -1922,19 +1922,14 @@ msgid "Link translation for"
msgstr "Enlazar traducción de"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
# defaultMessage: Linking this item with hyperlink in text
msgid "Linking this item with hyperlink in text"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
# defaultMessage: Links and references
msgid "Links and references"
msgstr ""

#: components/manage/Blocks/Listing/schema
Expand Down Expand Up @@ -2647,6 +2642,16 @@ msgstr "Rehacer"
msgid "Reduce complexity"
msgstr "Reducir complejidad"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item as related item
msgid "Referencing this item as related item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item with {relationship}
msgid "Referencing this item with {relationship}"
msgstr ""

#: components/theme/Anontools/Anontools
#: components/theme/Login/Login
#: components/theme/Register/Register
Expand Down Expand Up @@ -4329,11 +4334,6 @@ msgstr "Héroe"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
32 changes: 16 additions & 16 deletions locales/eu/LC_MESSAGES/volto.po
Original file line number Diff line number Diff line change
Expand Up @@ -744,8 +744,8 @@ msgid "Content rules from parent folders"
msgstr "Gurasoetan dauden eduki erregelak"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Content that link to this item
msgid "Content that link to this item"
# defaultMessage: Content that links or references to {title}
msgid "Content that links or references to {title}"
msgstr ""

#: components/manage/Controlpanels/ContentTypes
Expand Down Expand Up @@ -1918,19 +1918,14 @@ msgid "Link translation for"
msgstr "Lotu itzulpena"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Linking this item with
msgid "Linking this item with"
# defaultMessage: Linking this item with hyperlink in text
msgid "Linking this item with hyperlink in text"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
#: components/manage/Toolbar/More
# defaultMessage: Links To Item
msgid "Links To Item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Links to {title}
msgid "Links to {title}"
# defaultMessage: Links and references
msgid "Links and references"
msgstr ""

#: components/manage/Blocks/Listing/schema
Expand Down Expand Up @@ -2643,6 +2638,16 @@ msgstr "Berregin"
msgid "Reduce complexity"
msgstr "Konplexutasuna gutxitu"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item as related item
msgid "Referencing this item as related item"
msgstr ""

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: Referencing this item with {relationship}
msgid "Referencing this item with {relationship}"
msgstr ""

#: components/theme/Anontools/Anontools
#: components/theme/Login/Login
#: components/theme/Register/Register
Expand Down Expand Up @@ -4325,11 +4330,6 @@ msgstr "Hero"
msgid "html"
msgstr "HTML"

#: components/manage/LinksToItem/LinksToItem
# defaultMessage: hyperlink
msgid "hyperlink"
msgstr ""

#: config/Blocks
# defaultMessage: Image
msgid "image"
Expand Down
Loading

0 comments on commit c4106b0

Please sign in to comment.