diff --git a/tm/01.install.mdx b/tm/01.install.mdx index ae7bb16..4ba81a8 100644 --- a/tm/01.install.mdx +++ b/tm/01.install.mdx @@ -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'; diff --git a/tm/02.getStarted/02.setup.md b/tm/02.getStarted/02.setup.md index b7fa6f3..4fc2b34 100644 --- a/tm/02.getStarted/02.setup.md +++ b/tm/02.getStarted/02.setup.md @@ -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: diff --git a/tm/05.reference/12.fundementals/04.valueMapper.md b/tm/05.reference/12.fundementals/04.valueMapper.md index b4ad9a4..d98ae69 100644 --- a/tm/05.reference/12.fundementals/04.valueMapper.md +++ b/tm/05.reference/12.fundementals/04.valueMapper.md @@ -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. diff --git a/usync/01.uSync/00.install.mdx b/usync/01.uSync/00.install.mdx index 7a4aa7a..b367443 100644 --- a/usync/01.uSync/00.install.mdx +++ b/usync/01.uSync/00.install.mdx @@ -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'; diff --git a/usync/01.uSync/10.getStarted/06.deploy.md b/usync/01.uSync/10.getStarted/06.deploy.md index c90c795..0b66be9 100644 --- a/usync/01.uSync/10.getStarted/06.deploy.md +++ b/usync/01.uSync/10.getStarted/06.deploy.md @@ -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 diff --git a/usync/01.uSync/20.guides/10.debugging.md b/usync/01.uSync/20.guides/10.debugging.md index c4034d7..c78b917 100644 --- a/usync/01.uSync/20.guides/10.debugging.md +++ b/usync/01.uSync/20.guides/10.debugging.md @@ -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. diff --git a/usync/01.uSync/40.reference/04.Fundementals/01.valuemappers.md b/usync/01.uSync/40.reference/04.Fundementals/01.valuemappers.md index d3f7db9..16adebc 100644 --- a/usync/01.uSync/40.reference/04.Fundementals/01.valuemappers.md +++ b/usync/01.uSync/40.reference/04.Fundementals/01.valuemappers.md @@ -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. \ No newline at end of file +See the [uSync Mappers Source](https://github.com/KevinJump/uSync/tree/v16/main/uSync.Core/Mapping) for examples of how mappers can be implemented. \ No newline at end of file diff --git a/usync/02.complete/00.setup/01.install.mdx b/usync/02.complete/00.setup/01.install.mdx index 81e8679..bc03637 100644 --- a/usync/02.complete/00.setup/01.install.mdx +++ b/usync/02.complete/00.setup/01.install.mdx @@ -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'; diff --git a/usync/02.complete/03.guides/01.syncPublisher/01.publishSetup/01.index.md b/usync/02.complete/03.guides/01.syncPublisher/01.publishSetup/01.index.md index 2969988..eebedfa 100644 --- a/usync/02.complete/03.guides/01.syncPublisher/01.publishSetup/01.index.md +++ b/usync/02.complete/03.guides/01.syncPublisher/01.publishSetup/01.index.md @@ -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) diff --git a/usync/02.complete/03.guides/01.syncPublisher/02.publishConfig/05.security.md b/usync/02.complete/03.guides/01.syncPublisher/02.publishConfig/05.security.md index 9b1dac7..5eb0eb8 100644 --- a/usync/02.complete/03.guides/01.syncPublisher/02.publishConfig/05.security.md +++ b/usync/02.complete/03.guides/01.syncPublisher/02.publishConfig/05.security.md @@ -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.** diff --git a/usync/03.Forms.mdx b/usync/03.Forms.mdx index f86d76a..b2670c3 100644 --- a/usync/03.Forms.mdx +++ b/usync/03.Forms.mdx @@ -14,18 +14,10 @@ import TabItem from '@theme/TabItem'; - - -```cli -install-package uSync.Forms -``` - - ```cli