最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
MATLAB® には、パブリッシュの使用やライブ エディターでのライブ スクリプトまたはライブ関数の作成など、コードを他のユーザーに提示するオプションがあります。
実行可能な MATLAB コード、埋め込みの出力、書式設定されたテキストを含む、まとまりのある共有可能なドキュメントを作成する最も簡単な方法は、ライブ エディターを使用することです。サポートされている出力形式は、MLX、PDF、Microsoft® Word、HTML、および LaTeX です。詳細については、ライブ エディターでライブ スクリプトを作成を参照してください。
MATLAB コード ファイル (.m
) を "パブリッシュ" して、コード、コメントおよび出力が含まれる書式設定されたドキュメントを作成します。コードをパブリッシュする一般的な理由は、教育またはデモ用にドキュメントを他のユーザーと共有したり、コードの読みやすい外部ドキュメンテーションを生成することです。
次のコードは、矩形波のフーリエ級数展開を示しています。
マークアップ付き MATLAB コード | パブリッシュされたドキュメント |
---|---|
|
|
コードをパブリッシュするには、以下の手順に従います。
MATLAB スクリプトまたは関数を作成します。各セクションの先頭に 2 つのパーセント記号 (%%
) を挿入して、コードをステップまたはセクションに分割します。
ファイルの先頭と各セクション内に説明コメントを追加して、コードをドキュメント化します。
各セクションの先頭のコメントの中で、出力が読みやすくなるようにマークアップを挿入することができます。たとえば、上記の表のコードには次のマークアップが含まれます。
タイトル |
|
イタリックの変数名 |
|
LaTeX 式 |
|
メモ
プラットフォームとは異なるエンコードの文字を使用するテキストが含まれるファイルを保存またはパブリッシュすると、MATLAB ではそれらの文字が文字化けして表示されます。
コードをパブリッシュします。[パブリッシュ] タブで、[パブリッシュ] をクリックします。
既定では、MATLAB は html
という名前のサブフォルダーを作成します。ここには、コードが作成する HTML ファイルおよび各グラフィックス ファイルが格納されます。HTML ファイルには、コード、書式化されたコメントおよび出力が含まれます。また、PDF ファイルや Microsoft PowerPoint® プレゼンテーションなど、他の形式にパブリッシュすることもできます。他の形式へのパブリッシュの詳細は、出力ファイルの指定を参照してください。
MATLAB Online では、MATLAB は HTML または PDF のいずれかにパブリッシュして、出力とサポート ファイルを Published
フォルダーに保存します。MATLAB が出力を自動的に開くようにするには、Web ブラウザーでポップアップ ウィンドウを有効にします。結果は、https://matlab.mathworks.com/users/
形式の URL を使用してパブリックに使用できます。userid
/Published/filename
/index.html
上記の図の中にあるサンプル コードは、インストールされたドキュメンテーションの一部です。次のコマンドを実行して、エディターでコードを表示できます。
edit(fullfile(matlabroot,'help','techdoc','matlab_env', ... 'examples','fourier_demo2.m'))
MATLAB コード ファイルの最初にコメントを挿入することで、コードにヘルプを追加できます。MATLAB は、ユーザーがコマンド ウィンドウに help
file_name
と入力するとヘルプ コメントを表示します。詳細については、プログラムへのヘルプの追加を参照してください。
MATLAB ヘルプ ブラウザーまたは Web で表示するために独自の MATLAB ドキュメンテーション トピックを作成することもできます。詳細については、カスタム ドキュメンテーションの表示を参照してください。