ライブスクリプトと関数を共有およびエクスポートする方法

教育またはデモ用に、またはコードについての読みやすい外部ドキュメンテーションを提供するために、ライブスクリプトまたは関数を他のユーザーと共有できます。

次の表は、ライブスクリプトまたはライブ関数を共有するさまざまな方法を示しています。

共有方法	手順
ファイルを直接共有する。	ライブコードファイル (`.mlx`) を配布します。ファイルの受信者は、MATLAB^® 内で、最後に保存されたときと同じ状態でファイルを開いて表示できます (生成された出力を含む)。 MATLAB は、R2016a 以降でライブスクリプト、R2018a 以降でライブ関数をサポートしています。
MATLAB の外部で表示できるドキュメントにファイルをエクスポートする。サポートされている形式: PDF Microsoft^® Word HTML LaTeX マークダウン Jupyter^® Notebook	ライブスクリプトまたは関数を対話的にエクスポートするには、[ライブエディター] タブで、[エクスポート] を選択してから形式を選択します。対話型のエクスポートでサポートされている形式には、PDF、Microsoft Word、HTML、および LaTeX が含まれます。すべてのライブスクリプトと関数を 1 つのフォルダーにエクスポートするには、[ライブエディター] タブで [エクスポート] 、 [フォルダーをエクスポート] を選択します。MATLAB Online™ でエクスポートするには、[エクスポート] ではなく [保存] を選択します。開いた [エクスポート] ダイアログボックスで、エクスポートオプションをカスタマイズできます。 (R2023b 以降) PDF、Microsoft Word、および LaTeX にエクスポートする際に、用紙のサイズ、方向、および余白を変更する。 PDF、HTML、および LaTeX にエクスポートする際に、図の解像度と形式を変更する (エクスポートする前にファイルを実行する必要あり)。変換されたファイルは、ライブエディターで出力をインライン表示した場合のライブスクリプトまたは関数とほぼ同じ外観です。ライブスクリプトにコントロールまたはタスクが含まれている場合、ライブエディターはそれらをコードとして変換後のファイルに保存します。 LaTeX へのエクスポート時に個別の `matlab.sty` ファイルが存在していない場合、MATLAB はそのファイルを変換後のファイルと同じフォルダー内に作成します。LaTeX スタイルドキュメントとしても知られている STY ファイルを使用すると、変換後のファイルの外観をきめ細かく制御できます。あるいは、`matlab.editor` エクスポート設定を使用して変換後のファイルをエクスポート前にカスタマイズすることもできます。
	ライブスクリプトまたは関数をプログラムでエクスポートするには、関数 `export` を使用します。プログラムによるエクスポートでサポートされている形式には、PDF、Microsoft Word、HTML、LaTeX、マークダウン、および Jupyter Notebook があります。関数 `export` を使用すると、名前と値の引数を使用して変換後のファイルをカスタマイズできます。たとえば、変換後のファイルでコードを非表示にできるほか、図の解像度と形式、ドキュメントの用紙サイズ、向き、余白をカスタマイズできます。
全画面表示としてファイルを表示する。	ライブエディターでライブスクリプトまたは関数を開いた状態で、[ビュー] タブに移動し、[全画面表示] ボタンをクリックしてオンにします。ライブエディターはファイルを全画面モードで表示します。全画面モードを終了するには、画面の上部にマウスを移動して [ビュー] タブを表示し、[全画面表示] ボタンをクリックしてオフにします。
ファイルを MATLAB の標準のコードファイル (`.m`) として保存する。	ライブエディターでライブスクリプトまたは関数を開いた状態で、[ライブエディター] タブの [ファイル] セクションで、[保存] 、 [名前を付けて保存] を選択します。表示されたダイアログボックスで、[ファイルの種類] リストから `[MATLAB コードファイル (UTF-8) (*.m)]` を選択します。ファイルを配布すると、受信者は MATLAB 内でファイルを開いて表示できます。MATLAB は、ライブスクリプトまたはライブ関数の書式設定されたコンテンツを、新しいライブスクリプトまたはライブ関数内ではパブリッシュマークアップに変換します。
ファイルを MATLAB の標準のコードファイル (`.m`) として保存する。	ライブスクリプトまたは関数を標準のコードファイルとしてプログラムで保存するには、関数 `export` を使用し、名前と値の引数 `Format` を `"m"` として指定します。

共有前にコードを非表示

ライブスクリプトを共有またはエクスポートする前に、コードを非表示にすることを検討してください。ライブスクリプト内のコードを非表示にすると、ライブエディターには出力、ラベル付きのコントロール、タスク、および書式設定済みテキストのみが表示されます。ライブスクリプトのタスクがコードのみを表示してコントロールは表示しない構成になっている場合、コードを非表示にするとタスクは表示されません。コードを非表示にするのは、ライブスクリプト内のコントロールの値の変更だけを他のユーザーに行わせる場合、または他のユーザーに自分のコードを表示しない場合の共有で役立ちます。

コードを非表示にするには、ライブスクリプトの右にある [コードを非表示] ボタンをクリックします。[ビュー] タブにアクセスして、[ビュー] セクションでも [コードを非表示] をクリックできます。コードを再度表示するには、[インラインで出力] ボタンまたは [右側に出力] ボタンをクリックします。または、関数 export を使用してライブスクリプトを共有している場合は、名前と値の引数 HideCode を使用してコードを非表示にできます。

メモ

PDF、Microsoft Word、HTML、LaTeX、マークダウン、または Jupyter Notebook にエクスポートする場合、ライブエディターはコントロールおよびタスクをコードとして保存します。コントロールおよびタスクが含まれているライブスクリプトがあり、エクスポート前にコードを非表示にした場合、変換後のファイルにはコントロールもタスクも含まれません。