Help plugin - Revision history

Kormoran at 13:24, 1 December 2010

2010-12-01T13:24:19Z

← Older revision		Revision as of 13:24, 1 December 2010
Line 14:		Line 14:

	== Adding New Help Files ==		== Adding New Help Files ==
	# Open the help dialog ''Settings->~~Environmanet~~->Help Files'' and hit ''Add''.		# Open the help dialog ''Settings->Environment->Help Files'' and hit ''Add''.
	# Enter a name for the help files you want to add. This title will be shown in the "Help" menu; when you click on the title in the menu, the file will be opened. You will now be asked to browse for the file to add; do so if you just want to add a regular helpfile, an executable or a file type that the system can open automatically (i.e. .CHM files or other known file types in windows). If you are adding an URL, decline the invitation and write the URL in the textbox below the helpfile list. If you have some weird document format to open, write in the textbox a command line to launch the appropriate viewer, then click on the "This line represent a full command to be executed" box.		# Enter a name for the help files you want to add. This title will be shown in the "Help" menu; when you click on the title in the menu, the file will be opened. You will now be asked to browse for the file to add; do so if you just want to add a regular helpfile, an executable or a file type that the system can open automatically (i.e. .CHM files or other known file types in windows). If you are adding an URL, decline the invitation and write the URL in the textbox below the helpfile list. If you have some weird document format to open, write in the textbox a command line to launch the appropriate viewer, then click on the "This line represent a full command to be executed" box.
	# Click the OK button below. You did it.		# Click the OK button below. You did it.

	===Helpfile options===		===Helpfile options===
	*You can tell Code::Blocks to use a file as the default helpfile, checking the "This is the default help file" box. This way, that file will be shown whenever you press the ''''F1'''' key. Moreover, if you write the <code>$(keyword)<code> as default keyword (see below), this file will be searched for keywords (taking the word selected or the word below the cursor in the current surce file) and will be opened showing the corresponding topic, if present.		*You can tell Code::Blocks to use a file as the default helpfile, checking the "This is the default help file" box. This way, that file will be shown whenever you press the ''''F1'''' key. Moreover, if you write the <code>$(keyword)</code> as default keyword (see below), this file will be searched for keywords (taking the word selected or the word below the cursor in the current surce file) and will be opened showing the corresponding topic, if present.

	*You can tell Code::Blocks to open the helpfile on a topic of your choice, writing the correspondent keyword in the "Default keyword value" textbox. If the helpfile is the default helpfile and you use <code>$(keyword)<code> as default keyword, the editor will use the word under the cursor (or currently selected) in the current opened file as keyword, opening the default help file at the relevant topic. This will be true, however, only for the default helpfile: any other helpfile or document will not be searched this way. For example, if you have the language reference as default helpfile and add the standard library helpfile, you will have the language keyword explained when hitting ''''F1'''' on them, but won't have the library functions explained this way. Viceversa, setting the standard library helpfile as default will give you the F1 help on them but you will loose this feature for the language keywords.		*You can tell Code::Blocks to open the helpfile on a topic of your choice, writing the correspondent keyword in the "Default keyword value" textbox. If the helpfile is the default helpfile and you use <code>$(keyword)</code> as default keyword, the editor will use the word under the cursor (or currently selected) in the current opened file as keyword, opening the default help file at the relevant topic. This will be true, however, only for the default helpfile: any other helpfile or document will not be searched this way. For example, if you have the language reference as default helpfile and add the standard library helpfile, you will have the language keyword explained when hitting ''''F1'''' on them, but won't have the library functions explained this way. Viceversa, setting the standard library helpfile as default will give you the F1 help on them but you will loose this feature for the language keywords.

	*If your helpfile is an HTML file, you can tell Code::Blocks to open it with the embedded HTML viewer, checking the corresponding option.		*If your helpfile is an HTML file, you can tell Code::Blocks to open it with the embedded HTML viewer, checking the corresponding option.

Kormoran: Now this page should be much more helpful

2010-12-01T13:21:33Z

Now this page should be much more helpful

← Older revision		Revision as of 13:21, 1 December 2010
Line 9:		Line 9:

	[[Image:Man01.png\|right\|thumb\|Help File view]]		[[Image:Man01.png\|right\|thumb\|Help File view]]
			Code::Blocks comes with just its own help file: normally, developers need much more help and reference for language, libraries, protocols, file formats and so on. The help plugin makes all the needed documentation available from within Code::Blocks itself. Virtually any document can be integrated in the Code::Blocks help system, since the help plugin has the ability to launch external programs, if necessary, to view the added documents.

	== ~~Add~~ New Help Files ==		Once added a new help file or document, there will be a new entry in the "Help" menu to open it.
	* Open the help dialog ''Settings->Environmanet->Help Files'' and hit ''Add''.
	* Enter a name for the help files you want to add		== Adding New Help Files ==
	* Select one of the ~~below listened methods~~ to add ~~new help~~ files and ~~enter~~ the ~~url~~, command ~~or whatever~~ is shown below ~~into~~ the ~~textentry box~~.		# Open the help dialog ''Settings->Environmanet->Help Files'' and hit ''Add''.
			# Enter a name for the help files you want to add. This title will be shown in the "Help" menu; when you click on the title in the menu, the file will be opened. You will now be asked to browse for the file to add; do so if you just want to add a regular helpfile, an executable or a file type that the system can open automatically (i.e. .CHM files or other known file types in windows). If you are adding an URL, decline the invitation and write the URL in the textbox below the helpfile list. If you have some weird document format to open, write in the textbox a command line to launch the appropriate viewer, then click on the "This line represent a full command to be executed" box.
			# Click the OK button below. You did it.

			===Helpfile options===
			*You can tell Code::Blocks to use a file as the default helpfile, checking the "This is the default help file" box. This way, that file will be shown whenever you press the ''''F1'''' key. Moreover, if you write the <code>$(keyword)<code> as default keyword (see below), this file will be searched for keywords (taking the word selected or the word below the cursor in the current surce file) and will be opened showing the corresponding topic, if present.

			*You can tell Code::Blocks to open the helpfile on a topic of your choice, writing the correspondent keyword in the "Default keyword value" textbox. If the helpfile is the default helpfile and you use <code>$(keyword)<code> as default keyword, the editor will use the word under the cursor (or currently selected) in the current opened file as keyword, opening the default help file at the relevant topic. This will be true, however, only for the default helpfile: any other helpfile or document will not be searched this way. For example, if you have the language reference as default helpfile and add the standard library helpfile, you will have the language keyword explained when hitting ''''F1'''' on them, but won't have the library functions explained this way. Viceversa, setting the standard library helpfile as default will give you the F1 help on them but you will loose this feature for the language keywords.

			*If your helpfile is an HTML file, you can tell Code::Blocks to open it with the embedded HTML viewer, checking the corresponding option.

	== Formats ==		== Formats ==
Line 25:		Line 35:

	=== CHM Files ===		=== CHM Files ===
	You can find c++ chm help files at: http://onnerby.se/~daniel/chm/		You can find c++ chm help files at: http://onnerby.se/~daniel/chm/ (they does not work on Windows 7), just add them via the dialog.

	~~Just~~ add them via the dialog

	For Linux you have to install a chm viewer to be able to open chm files. There are severals like gnochm, kchmviewer, xchm and so on.		For Linux you have to install a chm viewer to be able to open chm files. There are severals like gnochm, kchmviewer, xchm and so on.

Mattn2 at 10:07, 15 November 2008

2008-11-15T10:07:20Z

← Older revision		Revision as of 10:07, 15 November 2008
Line 1:		Line 1:
	~~== General ==~~

	{{Infobox_Plugin\|		{{Infobox_Plugin\|
	name = Help \|		name = Help \|
Line 8:		Line 6:
	version =		version =
	}}		}}
			== General ==

	[[Image:Man01.png\|right\|thumb\|Help File view]]		[[Image:Man01.png\|right\|thumb\|Help File view]]

Mattn2: /* CHM Files */

2008-11-15T10:06:02Z

CHM Files

← Older revision		Revision as of 10:06, 15 November 2008
Line 27:		Line 27:
	=== CHM Files ===		=== CHM Files ===
	You can find c++ chm help files at: http://onnerby.se/~daniel/chm/		You can find c++ chm help files at: http://onnerby.se/~daniel/chm/

	Just add them via the dialog		Just add them via the dialog

	For Linux you have to install a chm viewer to be able to open chm files. There are severals like gnochm, kchmviewer, xchm and so on.		For Linux you have to install a chm viewer to be able to open chm files. There are severals like gnochm, kchmviewer, xchm and so on.

Mattn2 at 10:05, 15 November 2008

2008-11-15T10:05:26Z

@@ Line 1: / Line 1: @@
-[[Category:Code::Blocks Contrib Plugins]]
+== General ==
 {{Infobox_Plugin|
    name = Help |
@@ Line 8: / Line 9: @@
 }}
-[[Using yelp as a help viewer]]
+[[Image:Man01.png|right|thumb|Help File view]]
-[[Using devhelp as a help viewer]]
+== Add New Help Files ==
 In recent nightly snapshots the help plugin has been greatly enhanced to support MAN pages, too. On Linux they are usually installed anyway, for Windows you might want to download them e.g. from here: http://www.win.tue.nl/~aeb/linux/man

Franks at 18:46, 18 December 2007

2007-12-18T18:46:32Z

← Older revision		Revision as of 18:46, 18 December 2007
Line 9:		Line 9:

	[[Using yelp as a help viewer]]		[[Using yelp as a help viewer]]

			[[Using devhelp as a help viewer]]

	In recent nightly snapshots the help plugin has been greatly enhanced to support MAN pages, too. On Linux they are usually installed anyway, for Windows you might want to download them e.g. from here: http://www.win.tue.nl/~aeb/linux/man		In recent nightly snapshots the help plugin has been greatly enhanced to support MAN pages, too. On Linux they are usually installed anyway, for Windows you might want to download them e.g. from here: http://www.win.tue.nl/~aeb/linux/man

MortenMacFly: link to man pages for windows

2007-09-15T16:42:20Z

link to man pages for windows

← Older revision		Revision as of 16:42, 15 September 2007
Line 9:		Line 9:

	[[Using yelp as a help viewer]]		[[Using yelp as a help viewer]]

			In recent nightly snapshots the help plugin has been greatly enhanced to support MAN pages, too. On Linux they are usually installed anyway, for Windows you might want to download them e.g. from here: http://www.win.tue.nl/~aeb/linux/man

Rjmyst3 at 00:20, 22 March 2007

2007-03-22T00:20:12Z

← Older revision		Revision as of 00:20, 22 March 2007
Line 7:		Line 7:
	version =		version =
	}}		}}

			[[Using yelp as a help viewer]]

Sethjackson at 20:54, 6 December 2006

2006-12-06T20:54:39Z

← Older revision		Revision as of 20:54, 6 December 2006
Line 2:		Line 2:
	{{Infobox_Plugin\|		{{Infobox_Plugin\|
	name = Help \|		name = Help \|
	logo = [[Image:~~Generic~~-plugin.png]] \|		logo = [[Image:help-plugin.png]] \|
	developer = [[User:Ceniza\|Paúl Andrés Jiménez]] \|		developer = [[User:Ceniza\|Paúl Andrés Jiménez]] \|
	maintainer = Paúl Andrés Jiménez \|		maintainer = Paúl Andrés Jiménez \|
	version =		version =
	}}		}}

Sethjackson at 23:30, 4 December 2006

2006-12-04T23:30:36Z

← Older revision		Revision as of 23:30, 4 December 2006
Line 3:		Line 3:
	name = Help \|		name = Help \|
	logo = [[Image:Generic-plugin.png]] \|		logo = [[Image:Generic-plugin.png]] \|
	developer = [[User:Ceniza\|~~Ceniza~~]] \|		developer = [[User:Ceniza\|Paúl Andrés Jiménez]] \|
	maintainer = ~~Ceniza~~ \|		maintainer = Paúl Andrés Jiménez \|
	version =		version =
	}}		}}