Difference between revisions of "Creating IDE Help/ja"

From Lazarus wiki
Jump to navigationJump to search
(New page: {{Creating IDE Help}} {{Japanese Menu}} == LCLユニットのためのヘルプ == Whenever the user presses F1 for an Object Inspector property or on an identifier in the source edito...)
 
m (Added categories)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Creating IDE Help}}
+
{{LanguageBar|Creating IDE Help}}
  
 
{{Japanese Menu}}
 
{{Japanese Menu}}
Line 6: Line 6:
 
== LCLユニットのためのヘルプ ==
 
== LCLユニットのためのヘルプ ==
  
Whenever the user presses F1 for an Object Inspector property or on an identifier in the source editor the IDE searches the declaration and invokes the HTML viewer for the fpdoc item.
+
ユーザーが、オブジェクトインスペクタ上のプロパティや、ソースエディタの識別子上で、F1をおすと、IDEが宣言を探してfpdocアイテムのHTMLビュワーにジャンプします。
The items can be edited easily via the [[LazDoc]] tool.
+
このアイテムは簡単に[[FPDoc Editor]]ツールを使って編集できます。
 +
LCLのドキュメントの状態は、[[LCL Documentation Roadmap]]をみてください。
  
You can see the state of the LCL documentation here: [[LCL Documentation Roadmap]].
+
== IDEウインドウのためのヘルプ ==
 +
0.9.15以降にこの機能があります。
  
== IDEウインドウのためのヘルプ ==
+
IDEウインドウのヘルプ(例えば、'Object Inspector' や、 'Compiler Options'など)は、このWikiで文書化されています。
 +
 
 +
IDEには、マッピングファイル''docs/IDEWindowHelpTree.xml''があり、その中にIDEフォームやコントロールから、ヘルプ用のWikiページへジャンプするための情報が書かれています。
 +
 
 +
このマッピングファイルは、IDEのどこにあっても、Ctrl+Shift+F1を押して表示され、エディタで編集できます。
 +
(syneditのような全てのキーを取り込むコントロールは除きます)
 +
 
 +
このショートカットは、options -> key mappingで設定することができます。
  
This feature exists since 0.9.15.
+
IDEウインドウのルートページのドキュメントは、[[Lazarus IDE/ja]] です。
  
The help for the IDE windows (i.e. 'Object Inspector' or the 'Compiler Options') are documented in this wiki.
 
The IDE has a mapping file ''docs/IDEWindowHelpTree.xml'', which contains the paths from the various IDE forms/controls to wiki pages.
 
This mapping file is edited via an editor that is shown at any place in the IDE via Ctrl+Shift+F1, except for controls, that catches all keys, like synedit. You can set the short cut in the editor options -> key mapping.
 
  
The root page of the IDE window docs is [[Lazarus IDE]].
+
(訳注:Lazarusの日本語環境において、この機能は非常に多くの部分が未完成です。)
  
 
== FPCキーワードのためのヘルプ ==
 
== FPCキーワードのためのヘルプ ==
  
This feature exists since 0.9.15 and requires the FPC docs as HTML installed locally.
+
0.9.15以降にこの機能があります。また、ローカルにFPC docsがHTMLとしてインストールされていることが必要です。
  
This is invoked when the cursor in the source editor is above a keyword and the user pressed F1.
+
この機能は、ソースエディタのキーワード上にカーソルがあり、ユーザーがF1キーを押したときに、呼び出されます。
The IDE searches in the FPC html documentation for the ref.kwd file. This file is maintained by the FPC team and contains a list to all HTML pages.
+
IDEはFPCのHTML文書の中から、ref.kwdファイルを元に検索します。このファイルはFPCチームでメンテナンスされており、全てのHTMLページのリストを含んでいます。現在は、カスタムヘルプは実装されていません。
At the moment no custom help is implemented.
 
  
 
TODO: Document, where to get/ how to create FPC Html docs.
 
TODO: Document, where to get/ how to create FPC Html docs.
Line 33: Line 38:
 
== メッセージのためのヘルプ ==
 
== メッセージのためのヘルプ ==
  
This feature exists since 0.9.15 and requires the FPC sources installed locally.
+
0.9.15以降にこの機能があります。また、FPCソースがローカルにインストールされている必要があります。
  
This is invoked when the user presses F1 or uses the Help menu item of the message window.
+
この機能は、ユーザーがF1キーを押すか、メッセージウインドウのヘルプメニューを使うと呼び出されます。
  
Normally the IDE will search the errore.msg file in the FPC sources and show the comment for the message. But some messages like ''unit not found'' need extra help. The following describes how to do that:
+
通常、IDEはFPCソースのerror.msgファイルを探して、メッセージのコメントを表示します。
 +
しかし、''unit not found'' のようないくつかのメッセージは、他のヘルプが必要です。以下に、それを記述する方法を示します。
  
To add a wiki help page for a message, do the following:
+
メッセージのためのwikiヘルプページを追加する方法:
* Create a wiki page under the root [[Build messages]]
+
* [[Build messages]]の下にWikiページを作ります。
* Open ide/helpfpcmessages.pas and add a ''AddFPCMessageHelpItem'' line like:
+
* ide/helpfpcmessages.pasを開いて、''AddFPCMessageHelpItem''行を次のように追加します。:
 
<pre>
 
<pre>
 
   AddFPCMessageHelpItem('Can''t find unit',
 
   AddFPCMessageHelpItem('Can''t find unit',
 
                         'FPC_message:_Can_not_find_unit',': Can''t find unit ');
 
                         'FPC_message:_Can_not_find_unit',': Can''t find unit ');
 
</pre>
 
</pre>
The first parameter is the title shown in errors. The second parameter is the wiki URL. And the third parameter is the regular expression to match the message.
+
 
 +
最初のパラメータは、エラーの時に表示されるタイトルです。2番目のパラメータはWikiのURLです。3番目のパラメータはメッセージにマッチする正規表現です。
 +
 
 +
 
 +
訳注)ここでいうメッセージというのは、コンパイルするときに表示されるコンパイラメッセージです。
 +
 
 +
[[Category:Help and Docs/ja]]
 +
{{AutoCategory}}

Latest revision as of 09:16, 26 January 2020

Deutsch (de) English (en) 日本語 (ja) русский (ru)

日本語版メニュー
メインページ - Lazarus Documentation日本語版 - 翻訳ノート - 日本語障害情報


LCLユニットのためのヘルプ

ユーザーが、オブジェクトインスペクタ上のプロパティや、ソースエディタの識別子上で、F1をおすと、IDEが宣言を探してfpdocアイテムのHTMLビュワーにジャンプします。 このアイテムは簡単にFPDoc Editorツールを使って編集できます。 LCLのドキュメントの状態は、LCL Documentation Roadmapをみてください。

IDEウインドウのためのヘルプ

0.9.15以降にこの機能があります。

IDEウインドウのヘルプ(例えば、'Object Inspector' や、 'Compiler Options'など)は、このWikiで文書化されています。

IDEには、マッピングファイルdocs/IDEWindowHelpTree.xmlがあり、その中にIDEフォームやコントロールから、ヘルプ用のWikiページへジャンプするための情報が書かれています。

このマッピングファイルは、IDEのどこにあっても、Ctrl+Shift+F1を押して表示され、エディタで編集できます。 (syneditのような全てのキーを取り込むコントロールは除きます)

このショートカットは、options -> key mappingで設定することができます。

IDEウインドウのルートページのドキュメントは、Lazarus IDE/ja です。


(訳注:Lazarusの日本語環境において、この機能は非常に多くの部分が未完成です。)

FPCキーワードのためのヘルプ

0.9.15以降にこの機能があります。また、ローカルにFPC docsがHTMLとしてインストールされていることが必要です。

この機能は、ソースエディタのキーワード上にカーソルがあり、ユーザーがF1キーを押したときに、呼び出されます。 IDEはFPCのHTML文書の中から、ref.kwdファイルを元に検索します。このファイルはFPCチームでメンテナンスされており、全てのHTMLページのリストを含んでいます。現在は、カスタムヘルプは実装されていません。

TODO: Document, where to get/ how to create FPC Html docs.

メッセージのためのヘルプ

0.9.15以降にこの機能があります。また、FPCソースがローカルにインストールされている必要があります。

この機能は、ユーザーがF1キーを押すか、メッセージウインドウのヘルプメニューを使うと呼び出されます。

通常、IDEはFPCソースのerror.msgファイルを探して、メッセージのコメントを表示します。 しかし、unit not found のようないくつかのメッセージは、他のヘルプが必要です。以下に、それを記述する方法を示します。

メッセージのためのwikiヘルプページを追加する方法:

  • Build messagesの下にWikiページを作ります。
  • ide/helpfpcmessages.pasを開いて、AddFPCMessageHelpItem行を次のように追加します。:
  AddFPCMessageHelpItem('Can''t find unit',
                        'FPC_message:_Can_not_find_unit',': Can''t find unit ');

最初のパラメータは、エラーの時に表示されるタイトルです。2番目のパラメータはWikiのURLです。3番目のパラメータはメッセージにマッチする正規表現です。


訳注)ここでいうメッセージというのは、コンパイルするときに表示されるコンパイラメッセージです。