Specify encoding when loading documents

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Viewer MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-viewer -- dnx GroupDocs.Viewer.Mcp --yes
Folders, licensing and more →

This feature is supported for the following file types:

Different encodings use different byte sequences for characters, and opening a file in the wrong encoding leads to incorrect character rendering. To properly render a file, the correct encoding must be specified when opening the file. Another option is converting it to UTF-8 beforehand. By default GroupDocs.Viewer using UTF-8 encoding.

For examle, when you try to open sample-shift-jis.txt file in Notepad the text これはShift_JISエンコード用のサンプルテキストです。 will appear as strange symbols because ANSI is misinterpreting the byte values that are specific to Shift_JIS.

Shift_Jis text file opened in Notepad

To render text file properly you can set charset using LoadOptions class. In the following code snippet we’ll set Shift_JIS charset and render the text file to HTML:

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;

import java.nio.charset.Charset;

// ...

// Specify charset.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setCharset(Charset.forName("Shift_JIS"));

// Render a file.
try (Viewer viewer = new Viewer("sample-shift-jis.txt", loadOptions)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}

sample-shift-jis.txt is sample TXT file that is used in this example. Click here to download it.

The following image demonstrates the result:

Shift_Jis text file converted to HTML