| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| dcore:sce-ondemand_command [2016/05/14 03:52] – nitram | dcore:sce-ondemand_command [2016/08/31 05:42] (current) – nitram |
|---|
| ===== dCore sce-ondemand Command ===== | ===== dCore sce-ondemand Command ===== |
| |
| The sce-ondemand command is used to manage ondemand SCE(s). | The sce-ondemand command is used to manage OnDemand SCE(s). Adding an SCE to OnDemand creates an application entry in the (supported) Window Manager's OnDemand menu and auto generates a script in /etc/sysconfig/tcedir/ondemand/, example: |
| | <code> |
| | #!/bin/sh |
| | ondemand -e firefox.sce |
| | </code> |
| |
| Process: | This command loads and launches the SCE through a desktop file, found in /usr/local/share/applications/, or by directly issuing ''exec''. A pop-up message indicating //'Neither freedesktop file nor App executable exists. Please invoke from terminal or menu'// when attempting to launch an OnDemand extension usually means the application does not have a desktop file and is meant to be executed from command line. |
| *Adding an SCE to ondemand: | |
| *Creates an application entry in the Window Manager's 'ondemand' menu. | The contents of the OnDemand script may be manually modified to fix application launch issues or customize functionality. For example, this modified qpdfview OnDemand script ensures newly opened PDF documents open in tabbed mode: |
| *Adds a file in /etc/sysconfig/tcedir/ondemand/ containing the command to be executed. | |
| *A standard 'ondemand' file contains the following, which may be customized by the user if needed: | |
| <code> | <code> |
| ondemand -e <EXTENSION> | #!/bin/sh |
| | #ondemand -e qpdfview.sce |
| | sce-load qpdfview && qpdfview --unique |
| </code> | </code> |
| *The main effects of this command are that the respective extension is loaded and launched, either through a '.desktop'-file it provides under '/usr/{local/}share/applications/' or else directly by issueing ''exec''. | |
| |
| The menu entry corresponds to the name of the file under 'tce/ondemand/' which also may be changed at will. The ondemand command uses these file names with options ''-c, -r'', and extension names with options ''-l, -e''. When changing the file name under 'tce/ondemand/', the extension will be listed as available for ondemand. | If creating SCEs from list files (see sce-import -l command) it may be easiest to name the list file, and subsequent created SCE name, after the main executable to ensure it launches properly from an OnDemand menu. |
| |
| === Trouble-shooting === | The ''sce-ondemand'' command is a symlink evolved from ''ondemand'', simply running ''ondemand SCE'' is a shortcut to quickly add an existing SCE to OnDemand, example: |
| If the launching of an ondemand item is answered by a message like: "Neither freedesktop file nor App executable exists. Please invoke from terminal or menu." then one should adapt the content of the ondemand file. According to the behavior of the ''ondemand -e'' statement, the following may serve as reference. | <code> |
| <code>sce-load <EXTENSION> | ondemand firefox |
| exec <APPLICATION></code> | </code> |
| |
| This may be necessary, for instance, if the ondemand item is created for an extension built after a list of packages and the name of the list does not correspond to the executable. To avoid such hassle it seems advisable to generally name extension list after their main executable. | The easiest way to add an application to OnDemand is during the import process, review ''sce-import --help'' regarding ''sce-import -o'' (OnDemand). |
| |
| | As OnDemand is in dCore's default application path, OnDemand applications are accessible with terminal tab auto-complete prior to loading. In most cases, issuing the application's executable command, via terminal or Window Manager menu, will auto-load and immediately execute the application. |
| | <code> |
| | tc@box:~$ echo $PATH |
| | /home/tc/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/bb:/etc/sysconfig/tcedir/ondemand |
| | </code> |
| |
| Usage options from the 'sce-ondemand --help' command: | Usage options from the ''sce-ondemand --help'' command: |
| |
| sce-ondemand - Manage ondemand SCE(s). Adding an SCE to ondemand creates a | sce-ondemand - Manage ondemand SCE(s). Adding an SCE to ondemand creates a |
| ondemand menu, which provides a convenient way to load | ondemand menu, which provides a convenient way to load |
| less frequently used SCE(s) after boot. | less frequently used SCE(s) after boot. |
| | |
| Usage: | Usage: |
| | |
| sce-ondemand SCE Add SCE to ondemand, update menus. | sce-ondemand SCE Add SCE to ondemand, update menus. |
| sce-ondemand -c Display current ondemand SCE(s). | sce-ondemand -c Display current ondemand SCE(s). |
