[ { "path": ".github/FUNDING.yml", "content": "# These are supported funding model platforms\n\ngithub: [konne, seriousm]\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Create a report to help us improve\ntitle: ''\nlabels: bug\nassignees: ''\n\n---\n\n**Describe the bug**\nA clear and concise description of what the bug is.\n\n**To Reproduce**\nCode snipet, or better a small code example that shows the issue\n\n**Expected behavior**\nA clear and concise description of what you expected to happen.\n\n**Screenshots**\nIf applicable, add screenshots to help explain your problem.\n\n**Enviroment (please complete the following information):**\n - OS: [e.g. iOS]\n - .NET Framework: [e.g. NET452, netcore30]\n\n**Additional context**\nAdd any other context about the problem here.\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\nupdates:\n- package-ecosystem: nuget\n directory: \"/src\"\n schedule:\n interval: daily\n time: \"08:00\"\n timezone: Europe/Berlin\n target-branch: development\n\n- package-ecosystem: \"github-actions\"\n directory: \"/\"\n schedule:\n # Check for updates to GitHub Actions every weekday\n interval: \"daily\"\n" }, { "path": ".github/release-drafter.yml", "content": "categories:\n - title: 'Features'\n labels:\n - 'feature'\n - 'enhancement'\n - title: 'Bug Fixes'\n labels:\n - 'fix'\n - 'bugfix'\n - 'bug'\n - title: 'Maintenance'\n labels:\n - 'chore'\n - 'dependencies'\nchange-template: '- $TITLE @$AUTHOR (#$NUMBER)'\ntemplate: |\n ## Changes\n\n $CHANGES\n" }, { "path": ".github/workflows/compile.yml", "content": "name: .NET\n\non:\n push:\n branches: [ master, development ]\n paths-ignore:\n - '*.md'\n - 'docs/**'\n\n pull_request:\n branches: [ master, development ]\n paths-ignore:\n - '*.md'\n - 'docs/**'\n\n workflow_dispatch:\n branches: [ master, development ]\n paths-ignore:\n - '*.md'\n - 'docs/**'\n\njobs:\n build:\n runs-on: windows-latest\n\n steps:\n - name: checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0\n\n - name: Fetch all history for all tags and branches\n run: |\n git fetch --prune\n\n - name: Setup MSBuild.exe\n uses: microsoft/setup-msbuild@v2\n\n - name: Cache Nuget\n uses: actions/cache@v4.0.2\n with:\n path: ~/.nuget/packages\n key: ${{ runner.os }}-nugetv1-${{ hashFiles('**/packages.lock.json') }}\n restore-keys: |\n ${{ runner.os }}-nugetv1-\n\n - name: Build\n working-directory: src\n run: |\n dotnet restore --disable-parallel\n # dotnet build --disable-parallel --configuration Release\n # can't use pure dotnet build because gitversion issues\n msbuild ${{ github.event.repository.name }}.csproj -verbosity:minimal /p:Configuration=Release /property:DisableGitVersionTask=true\n\n # add check for PR against master from development -> build preRelease to nuget\n # if merged into master -> build Release -> nuget\n # if: github.ref == 'refs/heads/master' || (startsWith(github.ref, 'refs/tags/') && contains(github.ref,'-alpha'))\n #/property:NugetAPIKey=${{ secrets.NugetAPIKey }}\n" }, { "path": ".github/workflows/publish.yml", "content": "name: Publish\n\non:\n release:\n types: [ published ]\n\njobs:\n build:\n runs-on: windows-latest\n\n steps:\n - name: checkout\n uses: actions/checkout@v4\n\n - name: Setup MSBuild.exe\n uses: microsoft/setup-msbuild@v2\n\n - name: Write Fullkey.snk\n uses: RollyPeres/base64-to-path@v1\n with:\n filePath: ${{ github.workspace }}/src/fullkey.snk\n encodedString: ${{ secrets.SIGNKEY }}\n\n - name: Create msbuild params\n run: |\n echo \"::set-output name=params::${{ github.event.repository.name }}.csproj -verbosity:minimal /p:Configuration=Release /property:DisableGitVersionTask=true /property:GitVersion_NuGetVersion=${{ github.event.release.tag_name }} /property:Version=${{ github.event.release.tag_name }}\"\n id: msbuild\n \n - name: add nuget API Key for releases\n if: \"!github.event.release.prerelease\"\n run: |\n echo \"::set-output name=params::/property:NugetAPIKey=${{ secrets.NugetAPIKey }}\" \n id: apikey\n\n - name: Restore\n working-directory: src\n run: |\n dotnet restore --disable-parallel\n\n - name: Restore & Build & (Publish)\n working-directory: src\n run: |\n msbuild ${{ steps.msbuild.outputs.params }} ${{ steps.apikey.outputs.params }}\n rm -R .\\obj\\Release\n msbuild ${{ steps.msbuild.outputs.params }} ${{ steps.apikey.outputs.params }} /property:UnSigned=true\n\n - name: Upload Release Assets\n uses: softprops/action-gh-release@v2\n with:\n files: src/bin/Release/*.nupkg\n" }, { "path": ".github/workflows/release-drafter.yaml", "content": "name: Release\n\non:\n push:\n branches: [ master ]\n paths:\n - 'src/**'\n - '.github/workflows/release-drafter.yml'\n\njobs:\n release:\n runs-on: ubuntu-latest\n\n steps:\n - name: checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0\n\n - name: Fetch all history for all tags and branches\n run: |\n git fetch --prune\n\n - name: Install GitVersion\n uses: gittools/actions/gitversion/setup@v3.0.0\n with:\n versionSpec: '5.6.x'\n\n - name: Use GitVersion\n id: gitversion\n uses: gittools/actions/gitversion/execute@v3.0.0\n\n - name: create release\n id: create_release\n uses: release-drafter/release-drafter@v6\n with:\n tag: '${{ steps.gitversion.outputs.semVer }}'\n name: 'Release ${{ steps.gitversion.outputs.semVer }}'\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".gitignore", "content": "#ignore thumbnails created by windows\nThumbs.db\n#Ignore files build by Visual Studio\n*.obj\n*.exe\n*.pdb\n*.user\n*.aps\n*.pch\n*.vspscc\n*_i.c\n*_p.c\n*.ncb\n*.suo\n*.tlb\n*.tlh\n*.bak\n*.cache\n*.ilk\n*.log\n[Bb]in\n[Dd]ebug*/\n*.lib\n*.sbr\nobj/\n[Rr]elease*/\n_ReSharper*/\n[Tt]est[Rr]esult*\nSandbox\n*Sandbox*\n*.ncrunchsolution\n*.xap\nClientBin/*\n*.zip\n*.pfx\nExample.xlsx\npackages/\n.vs/\n*.nupkg\n\n# Jetbrain Rider Cache\n.idea/ " }, { "path": "CONTRIBUTING.md", "content": "Thanks for reporting an issue!\n\nPlease keep in mind that this project is not actively developed and that @MrCircuit and I (@SeriousM) don't work full-time on it.\n\nIf you have a clue how to resolve the issue please try to resolve it yourself and send us a Pull Request including unit tests.\n\nOpen-Source means not only the \"free\" availability of source code, it also means that the users are free to contribute to it to make it better.\n\nThank you for your help and understanding.\n" }, { "path": "LICENSE", "content": "Microsoft Public License (Ms-PL)\n\nThis license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.\n\n1. Definitions\n\nThe terms \"reproduce,\" \"reproduction,\" \"derivative works,\" and \"distribution\" have the same meaning here as under U.S. copyright law.\n\nA \"contribution\" is the original software, or any additions or changes to the software.\n\nA \"contributor\" is any person that distributes its contribution under this license.\n\n\"Licensed patents\" are a contributor's patent claims that read directly on its contribution.\n\n2. Grant of Rights\n\n(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.\n\n(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.\n\n3. Conditions and Limitations\n\n(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.\n\n(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.\n\n(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.\n\n(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.\n\n(E) The software is licensed \"as-is.\" You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.\n" }, { "path": "README.md", "content": "# WPFLocalizeExtension\n[![CodeFactor](https://www.codefactor.io/repository/github/xamlmarkupextensions/WPFLocalizeExtension/badge/master)](https://www.codefactor.io/repository/github/xamlmarkupextensions/WPFLocalizeExtension/overview/master)\n[![Nuget](https://img.shields.io/nuget/v/WpfLocalizeExtension.svg)](https://www.nuget.org/packages/WpfLocalizeExtension)\n![.NET](https://github.com/XAMLMarkupExtensions/WPFLocalizeExtension/workflows/.NET/badge.svg)\n[![Join the chat at https://gitter.im/SeriousM/WPFLocalizationExtension](https://badges.gitter.im/SeriousM/WPFLocalizationExtension.svg)](https://gitter.im/SeriousM/WPFLocalizationExtension?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n#### ...is a really the easiest way to localize any type of DependencyProperties or native Properties on DependencyObjects since 2008!\n\n## Supported Frameworks\n\n* .Net Framework 4.0+\n* .Net CORE 3.0+\n\n## Installation\n\n[NuGet Package](https://nuget.org/packages/WpfLocalizeExtension/)\n\n```net\ndotnet add package WPFLocalizationExtension\n```\n\n## Getting started\n\nComing soon\n\n## Documentation & Tutorial:\n[Documentation / Wiki](docs/README.md)\n\n## Localization Tools:\n[ResXManager (Visual Studio Plugin and StandAlone)](http://visualstudiogallery.msdn.microsoft.com/3b64e04c-e8de-4b97-8358-06c73a97cc68) \n[Zeta Resource Editor (Freeware)](http://www.zeta-resource-editor.com/index.html)\n\n-----\n\n## Products that use this Solution:\n\n![](/docs/SAPLogo.gif) SAP Crystal Reports, Version for Visual Studio .NET\n\n## License:\n[MS-PL](https://github.com/XAMLMarkupExtensions/WPFLocalizationExtension/blob/master/LICENSE)\n" }, { "path": "docs/BLoc-and-FELoc.md", "content": "# BLoc\n\nThis Extensions is a \n\n# FELoc" }, { "path": "docs/FAQ.md", "content": "# FAQ\n\n## Strong Name and signing\n\nThe current nuget is public signed, this is in general a good compromise, but there are sometimes issue like:\n\n* \"Could not load file or assembly 'WPFLocalizeExtension' ... Strong name signature could not be verified\n * xUnit can be solve with disable shadowCoping see #225\n * in general integrate [StrongNameSigner](https://github.com/brutaldev/StrongNameSigner)\n\nThere is also a long discussion here just some issues: #225 #150 #141 #110 #106\n\n\n## Issued Design mode\n\nWe try to do our best to have the extension as best as possible working in Visual Studio Designer, but in some cases\nthis doesn't work even everything is fine. Here some points / steps that can help:\n1. restart / reopen (xaml, sln, complete Visualt Studio)\n2. remove cache (bin/obj dirs + %USERPROFILE%\\AppData\\Local\\Microsoft\\VisualStudio\\\\**[VS VERSION]**\\Designer\\ShadowCache)\n3. check .net compile proj with any cpu or 32bit see #217\n\n\n## Missing Keys\n\nIf you like to see what keys are not translated you can easily register to the following event.\n\n```csharp\nLocalizeDictionary.Instance.MissingKeyEvent += Instance_MissingKeyEvent;\n```\n\nThe issue or bad design is that this is only triggered if you use the LocExtension, BLoc and not if you make codebehind translation.\nIf you do that you should use a different Event.\n\n```csharp\nLocalizeDictionary.Instance.GetLocalizedObject(....) \n\nLocalizeDictionary.Instance.DefaultProvider.ProviderError += ...\n```\n\n## Binding cannot be changed after it has been used\n\nBinding does not support any changes on Properties after it is bound the firts time. So if you like to do thinks like:\n\n```xaml\n{Binding Source={lex:Loc Foo}}\n{Binding StringFormat={lex:Loc Bar}}\n```\nThis will crash. For StringFormat use cases we have implemented a [StringFormatConverter](ValueConverters.md).\n\n## Access modifier for resource assemblies\nThe LocalizationExtension will fail to look up a localized value, if the resource is compiled with its access modifier set to internal.\nTo set up the resource build tool to use a public access modifier, open the resource file and change the value of the field.\n\n## NeutralResourcesLanguage in Assembly Manifest\nThe Assembly.cs contains sometimes the line _[assembly: NeutralResourcesLanguage(\"en-US\", UltimateResourceFallbackLocation.MainAssembly)]_\nwhich has side effects on resource lookups.\n\nPlease remove it.\n\n## Bad ResX Filename\nAs long as you are using custom ResX files that are not located under the Properties folder\nin your project you **may not call the file Resource**.\nIt will break the lookup mechanism for the resources.\n\n## Startuptime for Available Cultures Search with Resx Provider\nTo reduce the full search through all cultures and all resx files if they are available per\nculture you can set the searchlist of the culture. _ResxLocalizationProviderBase.SearchCultures_\n\n
Example\n

\n \n```csharp\n (LocalizeDictionary.Instance.DefaultProvider as ResxLocalizationProvider).SearchCultures =\n new List()\n {\n System.Globalization.CultureInfo.GetCultureInfo(\"de-de\"),\n System.Globalization.CultureInfo.GetCultureInfo(\"en\"),\n System.Globalization.CultureInfo.GetCultureInfo(\"he\"),\n System.Globalization.CultureInfo.GetCultureInfo(\"ar\"),\n };\n```\n\n

\n
\n" }, { "path": "docs/Features.md", "content": "# Features:\n\n* First of all: ITS FREE (and will stay free - refer to license section below)\n* Obtain stable results in\n\t* WPF applications using .NET 3.5 and higher\n\t* Windows Phone 7.x/8.x applications\n* **New:** Localization source/provider can be changed freely at arbitrary nodes\n\t* Use the Provider property in LocalizeDictionary to change the provider for the particular sub tree\n\t* Use the DefaultProvider property to set the provider for the whole application\n\t* Built-in RESX provider for resource file lookup (Default) - **fully backward compatible to older versions of this extension**\n\t* Interface for custom providers\n\t* Notification about provider changes and errors\n\t* Notification about resource changes\n\t* Get the list of all available cultures from a provider - or just take the bindable merged list from LocalizeDictionary\n\t* CSV provider project in the Tests folder as an example for custom providers\n\t* **Multiple UI thread support**\n* BLoc Extension that derives from Binding to support binding scenarios\n* Supports binding-like write style like \"Text = {lex:LocText ResAssembly:ResFile:ResKey}\"\n\t* Define a default assembly and / or resource file to reduce the key to ResAssembly::ResKey, ResFile:ResKey or even ResKey\n\t* Automatic key lookup: If no key is specified, the Name and Property Name of the target are used (e.g. MyButton_Content)\n\t* Default assembly, dictionary and culture can be changed dynamically at the RESX provider\n\t* Default assembly and dictionary inherit along the visual tree and can be redefined at each node\n* It is available at designtime (MS Expression Blend 3.0 & 4.0, MS VisualStudio 2008 & 2010 & 2012\n * not for dynamic loaded assemblies which only can be found at runtime and as long the resource (.resx) is built at designtime\n\t* Even for Silverlight!\n\t* No extra preview application needed\n\t* Offers a DesignValue Property to support custom values during design mode\n* Full support of various application scenarios\n\t* Works with normal dependency properties\n\t* Works with normal properties (e.g. Ribbon)\n\t* Works with control/data templates\n* Various culture setup features\n\t* List of available cultures\n\t* Culture swapping by Commands (SetCultureCommand)\n\t* Works with the .resx-fallback mechanism (e.g. en-us -> en -> invariant culture)\n\t* Supports culture forcing (e.g. \"this object has to be in english all the time\")\n\t* Buffering allows fast switching of the language at runtime\n\t* Offers a design language for visual testing at designtime\n\t* Offers a \"SpecificCulture\" to use as IFormatProvider (e.g. (123.20).ToString(LocalizeDictionary.SpecificCulture) = \"123.20\" or \"123,20\")\n\t* Does not alter the culture on Thread.CurrentCulture or Thread.CurrentUICulture (can be changed easily)\n* Code behind features:\n\t* Can be used in code behind to bind localized values to dynamic generated controls\n\t* Implements INotifyPropertyChanged for advanced use\n\t* Offers some functionality to check and get resource values in code behind (e.g. ResolveLocalizedValue)\n* Easy to use\n\t* Can be used with any resource file (.resx) across all assemblies (also the dynamic loaded one at runtime)\n\t* Does not need any initializing process (like \"call xyz to register a special localize dictionary\")\n\t* Can localize any type of data type, as long a TypeConverter exists for it\n* Example extensions included for\n\t* Formating e.g. \"this is the '{0}' value\" (not bindable at the moment)\n\t* Prefix and suffix values (currently with LocText extension)\n\t* Upper and lower Text\n* Last, but not least\n\t* Does not create any memory leaks\n\t* Leaves the UID property untouched\n\t* Does not need an additional build task\n\t* Is in use in various productive systems" }, { "path": "docs/GapText.md", "content": "# Gap Text\n\nUse a multibinding with the [StringFormatConverter](ValueConverters.md).\nThe first **parameter** is the StringFormat\nAll others are parameter.\n```XML\n\n \n \n \n \n \n \n\n```\n\nintegrate [SmartFormat](https://github.com/axuno/SmartFormat/wiki) so that we have even a possibility to have real i18n with pluralization,..." }, { "path": "docs/Installation-and-dependencies.md", "content": "### Installation\n\nThe library itself can be obtained by two ways: \n\n* If you just want to use it without the need of compiling it, use the NuGet package manager of your VisualStudio or download it directly from our [NuGet package](https://www.nuget.org/packages/WpfLocalizeExtension). \n* If you are interested in the project details, feel free to get your own copy of the source code from GitHub.\n\nBy using NuGet you just have to choose the projects where you want to use the extension - the rest is done automatically by NuGet as usual. \n\n### Dependencies\n\nStarting with version 1.0.3, the project depends on the project [XAML Markup Extensions](https://github.com/XAMLMarkupExtensions/XAMLMarkupExtensions). NuGet will automatically ask you to download this package along with the LocalizationExtension.\n" }, { "path": "docs/Keys.md", "content": "Keys are entered either directly after the extension name or using the Key property of the LocExtension class. Both will yield the same result (here with the key named Test):\n```xaml\n