Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
module:xtrn_sec [2019/05/30 23:40] – [External Programs Section] Added "install" section digital man | module:xtrn_sec [2020/04/22 20:35] – No manual installation needed. digital man |
---|
====== External Programs Section ====== | ====== External Programs Section ====== |
This module provide the "External Programs" (doors) menu for the [[:server:Terminal]] server users. | The ''xtrn_sec.js'' module provides the "External Programs" (doors) menu for the [[:server:Terminal]] server users. |
| |
===== Install ===== | ===== Install ===== |
This module is normally installed in stock command shells by default, but to install into a command shell, replace the line(s) in ''[[dir:exec]]/*.src'': | This module (''xtrn_sec'') should be the default value of SCFG->System->Loadable Modules->Xtrn Section. |
| |
| ===== Usage ===== |
| |
| The normally expected usage is just to invoke ''xtrn_sec.js'' with no arguments. If, however, you wish to have the module skip the menu of external program sections and go directly to the menu of available programs within one specific section, pass the internal-code of the desired program section section as and argument to ''xtrn_sec.js''. |
| |
| |
| Example (Baja): |
| <code Baja> |
| exec_bin xtrn_sec games |
| </code> |
| |
| Example (JavaScript): |
| <code JavaScript> |
| load('xtrn_sec.js', 'games'); |
| </code> |
| |
| ===== Configure ===== |
| |
| The ''xtrn_sec'' module supports the following configuration options in the ''[xtrn_sec]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: |
| |
| ^ Option ^ Default ^ Description ^ |
| | multicolumn | true | Use a multiple-column program list when there are more than 10 items | |
| | sort | false | Re-sort (alphabetically) the list of programs and program sections before displaying to the user | |
| | autoexec | false | Automatically execute a section's program when there is only one program available within that section | |
| | clear_screen_on_exec | false | Clear the screen before executing any/all programs | |
| | eval_before_exec | | Evaluate the specified JavaScript expression //before// executing any/all programs | |
| | eval_after_exec | | Evaluate the specified JavaScript expression //after// executing any/all programs | |
| |
| ===== Fonts ===== |
| |
| This module uses the ''[[custom:javascript:lib:fonts.js]] library'' and [[config:fonts.ini]] file to optionally load door-specific fonts before executing an external program and restore the default font upon returning from the external program. |
| |
xtrn_section | |
with: | |
exec_bin xtrn_sec | |
| |
and then recompile with [[util:Baja]] or just run the [[module:update]] module. | |
===== See Also ===== | ===== See Also ===== |
* [[:module:|module index]] | * [[:module:|Modules]] |
| |
| {{tag>doors fonts javascript}} |
| |