最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

MATLAB コードのパブリッシュと共有

MATLAB^® には、パブリッシュの使用やライブ エディターでのライブ スクリプトまたはライブ関数の作成など、コードを他のユーザーに提示するオプションがあります。

ライブ エディターでのライブ スクリプトの作成と共有

実行可能な MATLAB コード、埋め込みの出力、書式設定されたテキストを含む、まとまりのある共有可能なドキュメントを作成する最も簡単な方法は、ライブ エディターを使用することです。サポートされている出力形式は、MLX、PDF、Microsoft^® Word、HTML、および LaTeX です。詳細については、ライブ エディターでライブ スクリプトを作成を参照してください。

MATLAB コードのパブリッシュ

MATLAB コード ファイル (.m) を "パブリッシュ" して、コード、コメントおよび出力が含まれる書式設定されたドキュメントを作成します。コードをパブリッシュする一般的な理由は、教育またはデモ用にドキュメントを他のユーザーと共有したり、コードの読みやすい外部ドキュメンテーションを生成することです。

次のコードは、矩形波のフーリエ級数展開を示しています。

マークアップ付き MATLAB コード	パブリッシュされたドキュメント

コードをパブリッシュするには、以下の手順に従います。

1. MATLAB スクリプトまたは関数を作成します。各セクションの先頭に 2 つのパーセント記号 (%%) を挿入して、コードをステップまたはセクションに分割します。

2. ファイルの先頭と各セクション内に説明コメントを追加して、コードをドキュメント化します。

   各セクションの先頭のコメントの中で、出力が読みやすくなるようにマークアップを挿入することができます。たとえば、上記の表のコードには次のマークアップが含まれます。

   タイトル	%% Square Waves from Sine Waves %% Add an Odd Harmonic and Plot It %% Note About Gibbs Phenomenon
   イタリックの変数名	% As _k_ increases, ...
   LaTeX 式	% $$ y = y + \frac{sin(k*t)}{k} $$

   メモ

   プラットフォームとは異なるエンコードの文字を使用するテキストが含まれるファイルを保存またはパブリッシュすると、MATLAB ではそれらの文字が文字化けして表示されます。

3. コードをパブリッシュします。[パブリッシュ] タブで、[パブリッシュ] をクリックします。

   既定では、MATLAB は html という名前のサブフォルダーを作成します。ここには、コードが作成する HTML ファイルおよび各グラフィックス ファイルが格納されます。HTML ファイルには、コード、書式化されたコメントおよび出力が含まれます。また、PDF ファイルや Microsoft PowerPoint^® プレゼンテーションなど、他の形式にパブリッシュすることもできます。他の形式へのパブリッシュの詳細は、出力ファイルの指定を参照してください。

   MATLAB Online では、MATLAB は HTML または PDF のいずれかにパブリッシュして、出力とサポート ファイルを Published フォルダーに保存します。MATLAB が出力を自動的に開くようにするには、Web ブラウザーでポップアップ ウィンドウを有効にします。結果は、https://matlab.mathworks.com/users/userid/Published/filename/index.html 形式の URL を使用してパブリックに使用できます。

上記の図の中にあるサンプル コードは、インストールされたドキュメンテーションの一部です。次のコマンドを実行して、エディターでコードを表示できます。

edit(fullfile(matlabroot,'help','techdoc','matlab_env', ...
             'examples','fourier_demo2.m'))

ヘルプの追加とドキュメンテーションの作成

MATLAB コード ファイルの最初にコメントを挿入することで、コードにヘルプを追加できます。MATLAB は、ユーザーがコマンド ウィンドウに help file_name と入力するとヘルプ コメントを表示します。詳細については、プログラムへのヘルプの追加を参照してください。

MATLAB ヘルプ ブラウザーまたは Web で表示するために独自の MATLAB ドキュメンテーション トピックを作成することもできます。詳細については、カスタム ドキュメンテーションの表示を参照してください。

参考

publish

関連するトピック

• ライブ エディターでライブ スクリプトを作成
• パブリッシュ マークアップ
• パブリッシュの出力基本設定

外部の Web サイト

• MATLAB コードをエディターからパブリッシュする

ビデオ