Skip to content

checking links #81

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 16, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions tm/01.install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ To install Translation Manager you will first need to have [installed Umbraco.](
Translation Manager v16 runs on Umbraco v16
:::

## Install via NuGet Package Manager
If you have [installed your Umbraco site via NuGet](https://our.umbraco.com/documentation/Fundamentals/Setup/Install/install-umbraco-with-nuget) then you can also install Translation Manager from within Visual Studio by running the following command in the [Package Manager Console.](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell)
## Install via .NET CLI
If you have [installed your Umbraco site using .NET CLI](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates), you can also install Translation Manager from within Visual Studio by running the following command in the command-line.


import Tabs from '@theme/Tabs';
Expand Down
2 changes: 1 addition & 1 deletion tm/02.getStarted/02.setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ title: Multi-Language Setups
There are two ways of setting up Umbraco for multiple languages. You can either:

- have a content tree for each language, or
- run all of your languages through a single tree and use the Umbraco [Variants](https://our.umbraco.com/documentation/Fundamentals/Backoffice/Variants/) feature.
- run all of your languages through a single tree and use the Umbraco [Variants](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/variants) feature.

## Multiple Tree Setup.
If you want to have separate content for each language on your site you can do this by maintaining separate content trees within Umbraco, one for each language:
Expand Down
4 changes: 2 additions & 2 deletions tm/05.reference/12.fundementals/04.valueMapper.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ In order for Translation Manager to translate your content it needs to know what
Calculating what is or isn't text content is done with value mappers. Value mappers handle the exporting and importing of text values to and from Umbraco property values.

### How it Works.
When Translation Manager looks at a content page it will get a list of the [property editors](https://our.umbraco.com/documentation/Fundamentals/Backoffice/Property-Editors/) the page contains.
When Translation Manager looks at a content page it will get a list of the [property editors](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors) the page contains.

For each property editor Translation Manager will get the "Property Editor alias" name for the property (for example *Umbraco.Textbox*) and see if a value mapper has been loaded that can handle the property.

For some properties the text values are stored directly as the value of a property. but for more complex properties such as properties for [The Grid](https://our.umbraco.com/Documentation/Fundamentals/Backoffice/Property-Editors/Built-in-Property-Editors/Grid-Layout/) or [Nested Content](https://our.umbraco.com/Documentation/Fundamentals/Backoffice/Property-Editors/Built-in-Property-Editors/Nested-Content/) the values are actually stored within a JSON object. The value mappers for these properties are responsible for finding the correct location to read and write the content. Then the core Translation Manager code can concentrate on managing the translation process.
For some properties the text values are stored directly as the value of a property. but for more complex properties such as properties for [Block Grid](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/block-editor/block-grid-editor) or [Block List](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/block-editor/block-list-editor) the values are actually stored within a JSON object. The value mappers for these properties are responsible for finding the correct location to read and write the content. Then the core Translation Manager code can concentrate on managing the translation process.

### Creating a Translation
When a translation is created, the value mapper will export the text values out of the Umbraco properties, and Translation Manager will store the text value in a [translation node](node). These text values can then be used by a [translation connector](connector) to create the translation files.
Expand Down
4 changes: 2 additions & 2 deletions usync/01.uSync/00.install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ uSync v16 runs on Umbraco v16.x. See our [compatibility table](/SupportLifecycle
:::


## Install via NuGet Package Manager
If you have [installed your Umbraco site via NuGet](https://our.umbraco.com/documentation/Fundamentals/Setup/Install/install-umbraco-with-nuget), you can also install uSync from within Visual Studio by running the following command in the [Package Manager Console.](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell)
## Install via .NET CLI
If you have [installed your Umbraco site using .NET CLI](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates), you can also install uSync from within Visual Studio by running the following command in the command-line.


import Tabs from '@theme/Tabs';
Expand Down
4 changes: 2 additions & 2 deletions usync/01.uSync/10.getStarted/06.deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,14 +35,14 @@ Sometimes you might only want uSync to import at startup the first time it boots

When uSync sees this file it will run an import but then replace the file with a usync.stop file which stops import at startup process regardless of settings

[Once/Stop documentation](../reference/Fundementals/once)
[Once/Stop documentation](../guides/once)

## First Boot 🥇🥾
First Boot is a setting that controls how uSync behaves the very first time a site boots up.

With First Boot, you can define how a site will seed its settings. This is great if you want your new site to take certain settings/content the first time it starts.

[First Boot documentation](../reference/Fundementals/firstboot)
[First Boot documentation](../guides/firstboot)

## uSync.CommandLine

Expand Down
2 changes: 1 addition & 1 deletion usync/01.uSync/20.guides/10.debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The best way to do that is to turn on debug logging and work through what uSync

## Turning on Debug Logging

Logging in Umbraco 16 is managed via [Serilog](https://our.umbraco.com/documentation/Fundamentals/Code/Debugging/Logging/) which outputs all logging messages to files in the `App_Data/Logs` folder.
Logging in Umbraco 16 is managed via [Serilog](https://docs.umbraco.com/umbraco-cms/fundamentals/code/debugging/logging) which outputs all logging messages to files in the `App_Data/Logs` folder.

To turn on debug logging, add the following to the `appsettings.json` file.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Editors | Collection of EditorAliases for the DataTypes that the mapper handles.
IsMapper | Confirms that this mapper will map the propertyType supplied.

## SyncValueMapperBase
To aid with ValueMapper implementation, you should use the [SyncValueMapperBase](https://github.com/KevinJump/uSync/blob/v8/main/uSync8.ContentEdition/Mapping/SyncValueMapperBase.cs) class from the uSync.ContentMapper assembly. This base class handles some of the repetitive elements and has helpers for dependency checks.
To aid with ValueMapper implementation, you should use the [SyncValueMapperBase](https://github.com/KevinJump/uSync/blob/v16/main/uSync.Core/Mapping/SyncValueMapperBase.cs) class from the uSync.ContentMapper assembly. This base class handles some of the repetitive elements and has helpers for dependency checks.

## Examples
See the [uSync Mappers Source](https://github.com/KevinJump/uSync/tree/v8/main/uSync8.ContentEdition/Mapping) for examples of how mappers can be implemented.
See the [uSync Mappers Source](https://github.com/KevinJump/uSync/tree/v16/main/uSync.Core/Mapping) for examples of how mappers can be implemented.
4 changes: 2 additions & 2 deletions usync/02.complete/00.setup/01.install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ title: Installation
To install uSync.Complete you will first need to have [installed Umbraco.](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install)


## Install via NuGet Package Manager
If you have [installed your Umbraco site via NuGet](https://our.umbraco.com/documentation/Fundamentals/Setup/Install/install-umbraco-with-nuget), you can also install uSync.Complete from within Visual Studio by running the following command in the [Package Manager Console.](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell)
## Install via .NET CLI
If you have [installed your Umbraco site using .NET CLI](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates), you can also install uSync.Complete from within Visual Studio by running the following command in command-line.


import Tabs from '@theme/Tabs';
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ To setup uSync.Publisher, there are a few steps you need to follow:
4. [Send Content](send)

## More Details
You can find out more details, and look at all the config options in the [uSync.Publisher section of this documentation.](publisher)
You can find out more details, and look at all the config options in the [Configuring Publisher section.](../../../../category/configuring-publisher)
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ title: Security
uSync.Publisher signs all communications with a [HMAC authentication](https://en.wikipedia.org/wiki/HMAC) key using the AppId and AppKey settings from the `uSync.Publish.Config` file. Alongside this you should include some basic security configuration to secure your sites.

## Use Https
While uSync.Publisher doesn't force HTTPS communication between Umbraco instances it is strongly recommended that you do use HTTPs protocols when setting up server addresses. You can [configure Umbraco to force Https for all back office communication](https://our.umbraco.com/Documentation/Reference/Security/use-https#set-usessl-configuration-option) in the `appsettings.json` file.
While uSync.Publisher doesn't force HTTPS communication between Umbraco instances it is strongly recommended that you do use HTTPs protocols when setting up server addresses. You can [configure Umbraco to force Https for all back office communication](https://docs.umbraco.com/umbraco-cms/reference/security/ssl-https#set-usehttps-configuration-option) in the `appsettings.json` file.

## Use unique AppId/AppKey Values
When uSync.Publisher first runs it will generate a AppId and AppKey value for the config, it is recommended you then use this value to communicate between servers (making sure all servers have the same config). **Do not use blank or short AppId/AppKey values.**
Expand Down
8 changes: 0 additions & 8 deletions usync/03.Forms.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,18 +14,10 @@ import TabItem from '@theme/TabItem';
<Tabs
defaultValue="core"
values={[
{ label: 'Package Manager', value: 'pm', },
{ label: 'Dotnet', value: 'core', },
{ label: 'Package reference', value: 'ref' }
]
}>
<TabItem value="pm">

```cli
install-package uSync.Forms
```

</TabItem>
<TabItem value="core">

```cli
Expand Down