Outdated Localization Documentation?

Development Platform & Builds
, ,
1

I am following the Guide found at https://docs.unrealengine.com/latest/INT/Gameplay/Localization/Setup/index.html on how to set up localization in UE4 using https://docs.unrealengine.com/latest/INT/Gameplay/Localization/Commandlets/index.html as an additional reference.

When I just tried running GatherText with the provided sample localization config I get the following log output:

[2018.01.05-17.56.54:353][  0]LogInit: Executing Class /Script/UnrealEd.GatherTextCommandlet
[2018.01.05-17.56.55:627][  0]LogGameplayTags: Display: UGameplayTagsManager::DoneAddingNativeTags. DelegateIsBound: 0
[2018.01.05-17.56.55:706][  0]WorldracingGameEditor: Warning: WorldracingGameEditor: Log Started
[2018.01.05-17.56.56:442][  0]LogGatherTextFromSourceCommandlet: Warning: IncludePaths detected in section GatherTextStep0. IncludePaths is deprecated, please use SearchDirectoryPaths.
[2018.01.05-17.56.56:442][  0]LogGatherTextFromSourceCommandlet: Warning: ExcludePaths detected in section GatherTextStep0. ExcludePaths is deprecated, please use ExcludePathFilters.
[2018.01.05-17.56.56:442][  0]LogGatherTextFromSourceCommandlet: Warning: SourceFileSearchFilters detected in section GatherTextStep0. SourceFileSearchFilters is deprecated, please use FileNameFilters.
[2018.01.05-17.56.56:521][  0]LogGatherTextFromAssetsCommandlet: Warning: IncludePaths detected in section GatherTextStep1. IncludePaths is deprecated, please use IncludePathFilters.
[2018.01.05-17.56.56:521][  0]LogGatherTextFromAssetsCommandlet: Warning: ExcludePaths detected in section GatherTextStep1. ExcludePaths is deprecated, please use ExcludePathFilters.
[2018.01.05-17.56.56:521][  0]LogGatherTextFromAssetsCommandlet: Warning: PackageExtensions detected in section GatherTextStep1. PackageExtensions is deprecated, please use PackageFileNameFilters.
[2018.01.05-17.56.57:737][  0]LogGatherTextFromAssetsCommandlet: Warning: No assets matched the specified criteria.
[2018.01.05-17.56.57:739][  0]LogGenerateArchiveCommandlet: Error: No native culture specified.
[2018.01.05-17.56.57:739][  0]LogGatherTextCommandlet: Error: GatherTextStep3-GenerateGatherArchiveCommandlet reported an error.

This makes me worry that I am following outdated documentation and might thus run into unnecessary trouble.

So my primary question is this: Where do I find the up to date documentation regarding the UE4 Localization feature?

Secondly I feel like most documentation I find or use is rather outdated so there might be a general problem of how I am using the unrealengine.com site. Is there any special trick to search the site with having only the most recent version of documentation on any particular topic shown?

2

I ran into the same thing. Here is an updated version of Game.ini that worked for me:

;Common settings to be used for all commandlets as needed.
[CommonSettings]
SourcePath=./Content/Localization/Game
DestinationPath=./Content/Localization/Game
ManifestName=Game.manifest
ArchiveName=Game.archive
ResourceName=Game.locres
PortableObjectName=Game.po
;English
NativeCulture=en
;English
CulturesToGenerate=en
;French - Commented Out
;CulturesToGenerate=fr
;Italian - Commented Out
;CulturesToGenerate=it
;German - Commented Out
;CulturesToGenerate=de
;Spanish - Commented Out
;CulturesToGenerate=es

;Gather text from source code and configuration files.
[GatherTextStep0]
CommandletClass=GatherTextFromSource
SearchDirectoryPaths=./Source/
SearchDirectoryPaths=./Config/
ExcludePathFilters=*/Config/Localization/*
FileNameFilters=*.h
FileNameFilters=*.cpp
FileNameFilters=*.ini

;Gather text from assets in content.
[GatherTextStep1]
CommandletClass=GatherTextFromAssets
IncludePathFilters=./Content/*
ExcludePathFilters=*/Content/Localization/*
PackageFileNameFilters=*.umap
PackageFileNameFilters=*.uasset

;Create manifest with all gathered source text.
[GatherTextStep2]
CommandletClass=GenerateGatherManifest

;Create new archives/update existing archives with new entries from the manifest.
[GatherTextStep3]
CommandletClass=GenerateGatherArchive

;Import new translations from PO (portable object) files into existing archives.
[GatherTextStep4]
CommandletClass=InternationalizationExport
bImportLoc=true

;Export new source from existing archives into PO (portable object) files.
[GatherTextStep5]
CommandletClass=InternationalizationExport
bExportLoc=true

;Compile source text and translations into binary form for use by the application.
[GatherTextStep6]
CommandletClass=GenerateTextLocalizationResource
3

I think this is true, helped me work well. However it seems that ue4 deprecated the old workflow and turned to localization dashboard like here: A new, community-hosted Unreal Engine Wiki - Announcements - Epic Developer Community Forums

4

Sadly this is hardly a replacement for the apparently outdated documentation linked above as the documentation you linked to exclusively revolves around the use case where the Unreal Editor is used directly for translation. As this is not the normal workflow for most commercial products where translation is done by external teams without source code access or knowledge of the specifics of Unreal Engine.

I also highly doubt Epic actually deprecated automated translation import/export as they seem to still be using it themselves.