エディターを効率よく使う
研究プロジェクト内を移動し、言語に応じた支援と診断を確認して、広範囲の編集を安全に適用します。
このページの内容
CorTeX エディターでは、Markdown と LaTeX のソースを編集可能なプロジェクトファイルとして保ちながら、どちらの形式でも移動、補完、診断、プレビューへのリンクを利用できます。共同執筆者や投稿先に渡すソースの構造を崩さず、原稿内を効率よく移動するために活用してください。
ファイル間や文書構造内を移動する#
プロジェクトツリーにはサイドバーの ファイル、現在の作業には開いている文書のタブを使います。Cmd/Ctrl+P を押して クイックオープンを開き、ファイル名の一部を入力して Enter を押します。編集可能なワークスペースでは、同じメニューから 新しいファイルを作成も実行できます。ファイルでアクティブな Markdown または LaTeX ファイルの行を展開すると、その下のアウトラインから移動できます。長いセクションはエディター左端の余白にある山形アイコンで折りたたみ、同じ位置から再び開けます。現在のセクションは見出しが上部に固定表示されます。無効にするには、プロジェクトの操作 → エディタを開き、セクション見出しを固定表示の選択を外します。
CorTeX で解決できる LaTeX のセクション、環境、ラベル、引用、コマンド、インクルードファイルの記号には、言語に応じた移動機能が使えます。Markdown の見出し、プロジェクト内のパス、対応しているスライドのフロントマターにも、それぞれ補完と移動機能があります。項目を解決できない場合は、エディターのインデックスが誤っていると判断する前に、現在の論文の起点ファイルと、プロジェクト内のパスを確認してください。複数の論文がある場合、現在の論文はプロジェクトを開くときの既定の文書とは異なることがあります。
意図を保ちながら補完を使う#
コマンド、環境、参照、引用、プロジェクトファイル、パッケージオプション、Markdown のパスを途中まで入力した位置にキャレットを置き、Ctrl+Space を押して補完候補を開きます。矢印キーで候補を確認し、Enter または Tab で確定します。ソースを変更せず閉じるには Escape を押します。候補は、現在のファイル形式とプロジェクトに合わせて絞り込まれます。確定する前に、提案されたコマンドと必須の引数を確認してください。補完機能は構文を挿入できますが、論文に必要な手法、引用、主張までは判断できません。
学術的な文章には、主張の強さと根拠の条件が研究結果に合う場合に限り、学術表現パレットまたは Writing の提案を使います。数式の意味では、ソースに結び付いた記法を説明できますが、不明または曖昧な式を推測して説明することはありません。
ラベルへ移動して安全に名前を変更する#
たとえば、main.tex に Figure~\ref{fig:calibration}、sections/results.tex に \label{fig:calibration} があるとします。
- いずれかのラベルにキャレットを置いて
F12を押すか、右クリックして 定義へ移動を選びます。CorTeX で定義元のファイルが開き、ラベルが選択されることを確認します。 Shift+F12を押すか 参照へ移動を選び、プロジェクト内のファイルで解決された使用箇所をすべて確認します。一般的なラベルを単なるテキストとして検索するより安全です。F2を押すか 記号名を変更を選び、fig:calibration-mainと入力して、適用前にファイルごとの変更案を確認します。- そのラベルを含む論文をコンパイルします。図の参照が解決され、問題に未定義の参照が報告されていないことを確認します。
言語に応じた操作は、CorTeX が記号を解決できる位置にだけ表示されます。ラベルを組み立てるカスタムマクロ、コード例、通常の文章中での言及は、別途手作業で編集する必要があります。意図した使用箇所がプレビューに含まれていなければ、名前の変更を中止してください。
言語上の記号ではなく用語を変更する場合は、プロジェクト内の検索と置換を使い、別の意味を持つ一致箇所を除外してから、すべて置換の前に名前付きバージョンを保存します。
「問題」で現在の状態を確認する#
サイドバーで 問題を開き、最初のエラーを選ぶと、CorTeX がソース内の該当位置を表示します。それ以降の診断は、最初のエラーから派生していることがよくあります。エディターに電球アイコンが表示された場合、またはコンテキストメニューに クイック修正… がある場合は、内容を開いて変更点を正確に確認し、原稿の意味を保てる場合にだけ適用してください。すべての診断にクイック修正があるわけではありません。現在のソースの処理に失敗しても、LaTeX プレビューには最後に成功した PDF が残ることがあります。内容を確認する前に PDFを更新しましたと表示されていることを確かめてください。
エディターの操作と承認したアシスタントのパッチには、同じ共同編集用ソースの経路が使われ、各機能に明記されている場合は取り消せます。プロジェクト全体に及ぶ変更や破壊的な変更では、エディターの「元に戻す」だけに頼らず、バージョン履歴を使ってください。ソースの定義へ移動し、提案された変更を適用前に確認してから、プレビューに現在の版が反映されていることを確かめてみてください。記号名の変更ではなく、確認しながら用語を変更する場合は、プロジェクト全体を検索して置換するへ進んでください。