> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/yan-yu/13-portuguese.md). # ポルトガル語 ## はじめに この記事では、ポルトガル語の組版方法について説明します。つまり、ç、ã、é などのアクセント付き文字を正しく組版できるようにし、さらにハイフネーションのような言語固有の機能をサポートします。1つの文書内で英語とポルトガル語のように複数の言語を使う方法を探している場合は、次を参照してください。 [国際言語サポート](/latex/ja/yan-yu/03-international-language-support.md) 記事を参照してください。 ## pdfLaTeXを使ったポルトガル語の例 まずは次の pdfLaTeX の例から始めます。コード下のリンクを使って Overleaf で開くことができます。 ```latex \documentclass{article} % \usepackage[utf8]{inputenc} はもはや不要です（2018年以降） %フォント（出力）エンコーディングを設定する %-------------------------------------- \usepackage[T1]{fontenc} %LuaLaTeX や XeLaTeX では不要です %-------------------------------------- %ポルトガル語固有のコマンド %-------------------------------------- \usepackage[portuguese]{babel} %-------------------------------------- %ハイフネーション規則 %-------------------------------------- \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} %-------------------------------------- \begin{document} \tableofcontents \vspace{2cm} %2cm のスペースを追加 \begin{abstract} これは、ポルトガル語で書かれた文書の内容の簡単な要約です。 \end{abstract} \section{導入セクション} これは最初のセクションです。いくつか追加の要素を加えることができます そして、すべてが正しく書き出されます。さらに、ある単語がパスであって 非常に長くて切り詰める必要がある場合、babel は正しく切り詰めようとします、 言語に応じて。 \section{第二セクション} このセクションでは、定義するテキストコマンドで何が起こるかを確認します \[ \lim x = \theta + 152383.52 \] \end{document} ``` [この pdfLaTeX の例を Overleaf で開いてください。](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Sample+document+in+Portuguese\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+%5Cusepackage%5Butf8%5D%7Binputenc%7D+is+no+longer+required+%28since+2018%29%0A%0A%25Set+the+font+%28output%29+encoding%0A%25--------------------------------------%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D+%25Not+needed+by+LuaLaTeX+or+XeLaTeX%0A%25--------------------------------------%0A%0A%25Portuguese-specific+commands%0A%25--------------------------------------%0A%5Cusepackage%5Bportuguese%5D%7Bbabel%7D%0A%25--------------------------------------%0A%0A%25Hyphenation+rules%0A%25--------------------------------------%0A%5Cusepackage%7Bhyphenat%7D%0A%5Chyphenation%7Bmate-m%C3%A1tica+recu-perar%7D%0A%25--------------------------------------%0A%0A%5Cbegin%7Bdocument%7D%0A%5Ctableofcontents%0A%0A%5Cvspace%7B2cm%7D+%25Add+a+2cm+space%0A%0A%5Cbegin%7Babstract%7D%0AEste+%C3%A9+um+breve+resumo+do+conte%C3%BAdo+do+documento+escrito+em+Portugu%C3%AAs.%0A%5Cend%7Babstract%7D%0A%0A%5Csection%7BSe%C3%A7%C3%A3o+introdut%C3%B3ria%7D%0AEsta+%C3%A9+a+primeira+se%C3%A7%C3%A3o%2C+podemos+acrescentar+alguns+elementos+adicionais+%0Ae+tudo+ser%C3%A1+escrito+corretamente.+Al%C3%A9m+disso%2C+se+uma+palavra+%C3%A9+um+caminho+%0Amuito+longo+e+tem+de+ser+truncado%2C+babel+ir%C3%A1+tentar+truncar+corretamente%2C+%0Adependendo+do+idioma.%0A%0A%5Csection%7BSegunda+se%C3%A7%C3%A3o%7D%0AEsta+se%C3%A7%C3%A3o+%C3%A9+para+ver+o+que+acontece+com+comandos+de+texto+que+definem%0A%0A%5C%5B+%5Clim+x+%3D++%5Ctheta+%2B+152383.52+%5C%5D%0A%5Cend%7Bdocument%7D) この例では次の出力が生成されます: ![OL2port1.png](/files/ccd68a0aec72fd01de1f1bb9cb0243428f5591b7) ### テキストファイル: 整数と文字 LaTeX 入力などの任意のテキストファイルは `.tex` ファイルにすぎず、それは数値（整数）値のストリームであり、〜の仕組みとして使われています *表す* テキストの文字を表します。したがって、テキストファイルを処理するには、整数値の系列を走査（読み取り/処理）する必要があります。しかし、重要な疑問が生じます。 *どの文字集合が* 特定のテキストファイルに含まれる整数値によって実際には表されているのでしょうか。言い換えると、それらの整数値はどのように *エンコードされた*：テキストファイル内の整数から、それらが表すことになっている対応する文字への、正しい（意図された）「マッピング」（エンコーディング）とは何でしょうか *表す*? テキストファイルは、さまざまなコンピューティング環境で生成できます。つまり、異なる国や大陸にまたがり、多種多様なデバイス、オペレーティングシステム、編集ツールを使って生成できます。テキストファイルの作成者は、テキストファイルに含まれる個々の文字を表すために選んだ整数値の並びを生成・保存する際、言語などの地域的要件に応じて異なるテキストエンコーディングを使用または適用する可能性があります。生成されたテキストファイルが同じエンコーディングを使う互換性のある技術的エコシステム内にとどまっていれば、これはうまく機能するかもしれません。しかし、そうしたファイルがまったく異なる環境に移された場合はどうなるでしょうか。多くのテキストファイルには、生成に使用されたエンコーディングを示す情報が含まれていないからです。 明らかに、テキストデータの作成者（発生源）と利用者（使用者）は、何らかの形で使用されているエンコーディング（対応付け）について合意しなければなりません。さもないと *エンコードエラー* ファイル内の整数データと、それが表していると想定される文字集合の不一致により、エンコードエラーが発生しやすくなります。テキストファイルの整数値を文字に正しく対応付けることに加え、それらの文字をその後視覚的に表示するには、目的の文字の視覚表現を出力するためのデータ（字形、あるいはビットマップですら）を提供できるフォントの何らかの形が必要です。 ### 入力エンコーディング: inputenc、UTF-8 と 2018年の LaTeX の変更 歴史的には、LaTeX の入力を含むテキストファイルの生成・処理にさまざまな 8 ビットエンコーディングが使われていました。長い話を手短にすると、LaTeX の開発者は、次のものを作成しました `inputenc` エンコーディングの問題に対処するためのパッケージで、さまざまなエンコーディングで作成されたテキストファイルを異なる LaTeX 環境間で転送できるようにしました。 しかし、時が経つにつれて、ユーザーやソフトウェア開発者は複数の 8 ビットエンコーディングから Unicode とその UTF-8 エンコーディング方式へ移行し、これがテキストファイルのエンコードの事実上の標準となりました。2018年以前は、UTF-8 でエンコードされたファイルを処理するために、LaTeX 文書のプリアンブルに次の行が含まれていました ```latex \usepackage[utf8]{inputenc} ``` 上の例には次の行が含まれていないことに読者は気づくかもしれません `\usepackage[utf8]{inputenc}` 文書のプリアンブルにあります。なぜでしょうか？ これは2018年に導入された LaTeX の重要な変更、つまり既定の *入力* エンコーディングとして UTF-8 に切り替わったことによるものです。pdfLaTeX で組版され、UTF-8 でエンコードされたテキストを使用する文書は、Overleaf で作成・組版されたものを含め、もはや *必要が* 含める必要がなくなりました `\usepackage[utf8]{inputenc}` ただし、 [そうしても害はありません](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/)。詳細は以下を参照してください [LaTeX News の 2018年4月号](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/) および Overleaf のブログ記事 [*TeX Live のアップグレード—2019年9月*](https://www.overleaf.com/blog/tex-live-upgrade-september-2019)。Overleaf で作成されたすべてのテキストファイルは UTF-8 でエンコードされています。 ### 出力エンコーディング: fontenc パッケージ 入力ファイルに含まれる文字を正しく組版するには、それらの文字を適切なものに対応付ける必要があります *出力字形* (グリフ) を文書の組版に使用されるフォント内に含める必要があります。この「出力エンコーディング」は、次の別のパッケージによって処理されます `fontenc`. 使用するには `fontenc` 次のようなエンコーディングを使って、文書のプリアンブルに次の行を含めます [T1 エンコーディング](http://mirrors.ctan.org/macros/latex/base/encguide.pdf)、これはラテン系言語に含まれるアクセント付き文字をサポートします: ```latex \usepackage[T1]{fontenc} ``` を使うと `T1` フォントエンコーディングは、〜を介して `\usepackage[T1]{fontenc}`、ほかにも利点があります: * LaTeX の既定の OT1 フォント（「出力」）エンコーディングは 7 ビットで、128 文字しかエンコードできず、フォント内に含まれる本物のアクセント付き文字の字形にアクセスできません。 `OT1` エンコーディングでは、TeX エンジンが、基底文字に重ねてずらしたアクセント文字を組み合わせて組版することで、アクセント付き文字を「擬似的」に作成します。 * TeX エンジンが〜に頼らざるを得ない場合 *構成* アクセント付き文字の構成は、PDF からのテキストのコピー/貼り付けに影響します。構成されたアクセント付き文字を含むテキストをコピーすると、次の結果になります *2つの別々の文字* が貼り付けられます。つまり、基底文字とアクセント文字です。〜を使うと `T1` この問題を回避できます。 * を使うと `T1` エンコーディングを使って本物のアクセント付き文字にアクセスすると、ハイフネーションが改善されます。 ### LaTeX の T1 フォントエンコーディング 次の表は、〜を示しています `T1` フォントエンコーディングです。これは文書の22ページから再掲されたものです *LaTeX のフォントエンコーディング* これは [CTAN で入手できます](http://mirrors.ctan.org/macros/latex/base/encguide.pdf). ![](/files/2b82c1a98d3d05b3779e8f4ca56bbc9b08804e33) ### コピー＆ペーストの例 次の最小例では、〜を使用していません `fontenc`、アクセント付き文字を含むテキストのコピー/貼り付けに関する問題を示しています。 ```latex \documentclass{article} \begin{document} 導入セクション（OT1エンコーディング） { \fontencoding{T1}\selectfont 導入セクション（T1エンコーディング） } \end{document} ``` [Overleaf でこの例を開く](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demonstrating+copy+and+paste+with+font+encodings\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASe%C3%A7%C3%A3o+introdut%C3%B3ria+%28OT1+encoding%29%0A%0A%7B%0A%5Cfontencoding%7BT1%7D%5Cselectfont+Se%C3%A7%C3%A3o+introdut%C3%B3ria+%28T1+encoding%29%0A%7D%0A%5Cend%7Bdocument%7D) 最初のテキストは、LaTeX の既定の `OT1` エンコーディングで組版されるため、「擬似的な」アクセント付き文字になります。次の LaTeX コード: ```latex \fontencoding{T1}\selectfont ``` 〜を使用するよう切り替えます `T1` エンコーディングにより、LaTeX はアクセント付き文字の字形を組版します。上の例で生成された PDF からテキストをコピーすると、次のようになるはずです: 導入セクション（OT1エンコーディング） 導入セクション（T1エンコーディング） 〜に注目してください `OT1` エンコードされたテキストには実際のアクセント付き文字が含まれていない一方で、〜でエンコードされたテキストにはそれらが含まれています `T1` にはそれらが含まれています。コピー/貼り付けの結果は、アクセント付き文字を含むテキストをコピー/貼り付けしている PDF を表示するために使用しているアプリケーションにも依存します。 ## 言語固有のパッケージとコマンド LaTeX の既定の機能を拡張し、適切なハイフネーションと文書要素名の翻訳を提供するには、〜を読み込みます `babel` package `ポルトガル語` language オプションを使用します。 ```latex \usepackage[portuguese]{babel} ``` でご覧のとおり [pdfLaTeX を使った例](#portuguese-example-using-pdflatex)、“Abstract” と “Contents” の代わりに、ポルトガル語の “Resumo” と “Conteúdo” が使われています。 ブラジルポルトガル語のローカライズを使う必要がある場合は `brazilian` の代わりに `ポルトガル語` を言語パラメータとして使用して `babel`. ## ハイフネーション この `babel` パッケージは通常、言語固有のハイフネーション機能をうまく提供しますが、特定の単語が正しくハイフネートされない場合、それを補助するパッケージがあります。たとえば、プリアンブルに次のものを追加できます `hyphenat` パッケージをプリアンブルに追加します: ```latex \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} ``` 2行目は、ハイフネーション規則が定義されたスペース区切りの単語の一覧です。特定の *単語*、次のように書きます `{\nobreak word}` 文書内で、または次の中に含めます `\mbox{単語}`. ## さらに読む 詳細については * [XƎLaTeX による現代フォントのサポート](/latex/ja/fonto/03-xelatex.md) * [引用と引用符の組版](/latex/ja/yan-yu/04-typesetting-quotations.md) * [国際言語サポート](/latex/ja/yan-yu/03-international-language-support.md) * [中国語](/latex/ja/yan-yu/06-chinese.md) * [フランス語](/latex/ja/yan-yu/07-french.md) * [ドイツ語](/latex/ja/yan-yu/08-german.md) * [ギリシャ語](/latex/ja/yan-yu/09-greek.md) * [イタリア語](/latex/ja/yan-yu/10-italian.md) * [日本語](/latex/ja/yan-yu/11-japanese.md) * [韓国語](/latex/ja/yan-yu/12-korean.md) * [アラビア語](/latex/ja/yan-yu/05-arabic.md) * [ロシア語](/latex/ja/yan-yu/14-russian.md) * [スペイン語](/latex/ja/yan-yu/15-spanish.md) * [LaTeX2εへのそれほど短くない入門](http://www.ctan.org/tex-archive/info/lshort/) * [WikiBooks の LaTeX/Internationalization](http://en.wikibooks.org/wiki/LaTeX/Internationalization) * [WikiBooks の LaTeX/Special\_Characters](http://en.wikibooks.org/wiki/LaTeX/Special_Characters) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/ja/yan-yu/13-portuguese.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.