Revision [11589]

Last edited on 2010-12-20 16:21:29 by coolpup
Additions:
Menu categories: selected from ///etc/xdg/menus/hierarchy//
Deletions:
Menu categories: selected from ////etc/xdg/menus/hierarchy//


Revision [11588]

Edited on 2010-12-20 16:20:45 by coolpup
Additions:
Menu categories: selected from ////etc/xdg/menus/hierarchy//


Revision [10873]

Edited on 2010-11-18 05:26:36 by coolpup
Additions:
http://www.murga-linux.com/puppy/viewtopic.php?p=468517#468517
Deletions:
----
==Categories==
CategoryDocumentation


Revision [9989]

Edited on 2010-10-21 15:01:25 by coolpup
Additions:
[[http://www.murga-linux.com/puppy/viewtopic.php?t=59013 Pdebthing]]


Revision [9030]

Edited on 2010-08-25 08:40:55 by coolpup
Additions:
===Software Package Creation===
For packages which __require a menu entry__ perform the following:
Deletions:
For the creation of software packages which __require a menu entry__ perform the following:


Revision [9029]

Edited on 2010-08-25 08:37:53 by coolpup
Additions:
Icon location: ///usr/share/pixmaps//
Icon file format: //.xpm//, or //.png//, is preferred
Icon size: //48x48// (use mtPaint for re-sizing)
Icon=abiword48.png
CategoryDocumentation
Deletions:
With regards to .pet package creation where should the menu icon files be placed and what size should they be?
- Location: **/usr/share/pixmaps**
- Format: **.xpm** format; failing that, **.png** is to be preferred
- Size: one of **24x24** for the sub-menu and one of **48x48** for use with a possible desktop shortcut
Icon=abiword24.png
CategoryHowTo


Revision [7861]

Edited on 2010-06-26 07:24:23 by coolpup
Additions:
- Place it in this directory: **/usr/share/applications**
Deletions:
- Once the file is created it needs to be located in this directory: **/usr/share/applications**


Revision [7848]

Edited on 2010-06-26 05:44:31 by coolpup
Additions:
- Format: **.xpm** format; failing that, **.png** is to be preferred
- Size: one of **24x24** for the sub-menu and one of **48x48** for use with a possible desktop shortcut
Deletions:
- Format: **.xpm** format; failing that, **.png** is to be preferred.
- Size: The .pet software package should contain a minimum of two icons, one of **24x24** for the sub-menu and one of **48x48** for use with a possible desktop shortcut


Revision [7847]

Edited on 2010-06-26 05:43:06 by coolpup
Additions:
Keys are either optional or required. The first three {key,value} pairs from the template are required; and the last two are optional but required for a menu icon to appear in the desired menu location.
Deletions:
Keys are either optional or required. The first three {key,value} pairs from the template are required; and the last two are optional but required for a menu icon to appear.


Revision [7845]

Edited on 2010-06-26 05:08:57 by coolpup
Additions:
- Size: The .pet software package should contain a minimum of two icons, one of **24x24** for the sub-menu and one of **48x48** for use with a possible desktop shortcut
Deletions:
- Size: The .pet software package should contain a minimum of two icons, one of 24x24 for the sub-menu and one of 48x48 for use with a desktop shortcut if the user creates one


Revision [7844]

Edited on 2010-06-26 05:07:16 by coolpup
Additions:
- Location: **/usr/share/pixmaps**
Deletions:
- Location:**/usr/share/pixmaps**


Revision [7843]

Edited on 2010-06-26 05:05:26 by coolpup
Additions:
With regards to .pet package creation where should the menu icon files be placed and what size should they be?
- Location:**/usr/share/pixmaps**
- Format: **.xpm** format; failing that, **.png** is to be preferred.
- Size: The .pet software package should contain a minimum of two icons, one of 24x24 for the sub-menu and one of 48x48 for use with a desktop shortcut if the user creates one
Therefore, the //abiword.desktop// file would typically consist of:
Name=AbiWord
__All Puppy packagers are advised to use this template for the sake of standardization__. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
Deletions:
With regards to PET package creation where should the menu icon files be placed and what size should they be (16x16, 24x24, or 48x48)?
There are necessarily different standard locations for different types of icons.
**/usr/local/libs/X11/mini-icons** is for all of the sub-menu icons and the preferred size is 24x24 although most of the legacy icons are 16x16. These smaller versions will eventually be weeded out as resolutions increase and applications are updated. They were a legacy of early versions of JWM which did n0t support larger menu icons.
**/usr/local/libs/X11/pixmaps** is only for the desktop icons that are part of the packaged desktop themes and their associated icons for the 1st level menus. For desktop icons the preferred size is 48x48. For 1st level menu icons the preferred size is 24x24. We also need to standardise on a given set of icons that constitutes a desktop theme. Some themes call icons by one name, others by another. That causes many problems. We are keen to ensure that /usr/local/libs/X11/pixmaps is kept exclusively for those icons that are used in the pinboard and 1st level menus. That is because that is what Barry's desktop icon switcher uses. We insist that only desktop theme icons go in /usr/local/lib/X11/pixmaps where they are regularly overwritten by themes from the /usr/local/libs/X11/themes directories.
Legacy locations from other Linux distributions (Debian, Red Hat, etc.) [We would like to be able to do away with them but the first converted .DEB or .RPM application that installs will place its own icons in there anyway.]
- **/usr/share/icons** is for application icons installed from 3rd party pet files and called from ///usr/share/applications/*.desktop files//
- **/usr/share/pixmaps** is for application icons installed from 3rd party PET files and called from ///usr/share/applications/*.desktop files//
The preferred format for __all__ icons, regardless of their purpose, is XPM format. Failing that, PNG is to be preferred. Renaming PNG files with an XPM extension maintains some consistency of naming, if not underlying format.
The PET software package should contain not one but __two__ icons:
- one of 24x24 for the sub-menu (placed in ///usr/local/lib/X11/mini-icons//) and called into the menu from the associated ///usr/share/applications/*.desktop// file
- one of 48x48 for use with a desktop shortcut if the user creates one; the latter icon should be placed in either /usr/share/pixmaps or /usr/share/icons - /usr/share/pixmaps is preferred
Therefore the //abiword.desktop// file would consist of:
Name=AbiWord word processor
__All Puppy packagers are encouraged to use this template for the sake of standardization__. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].


Revision [5916]

Edited on 2010-02-28 13:18:44 by coolpup
Additions:
- [[compiling Compile, install, & create a .pet software package]]
Deletions:
- [[compiling Compile, install, & create a PET software package]]


Revision [5915]

Edited on 2010-02-28 13:18:06 by coolpup
Additions:
===Menu and Desktop Icons===
===Appendix===
Deletions:
====Menu and Desktop Icons====
====Appendix====


Revision [5914]

Edited on 2010-02-28 13:15:30 by coolpup
Additions:
The rest of this page explains how to create a //.desktop// file:
- Create a text file using the template displayed in the //Appendix// below
- Once the file is created it needs to be located in this directory: **/usr/share/applications**
The entries in the file are {key,value} pairs in the format: **Key=Value**
Keys are either optional or required. The first three {key,value} pairs from the template are required; and the last two are optional but required for a menu icon to appear.
Note that the "Encoding" key is deprecated, i.e. obsolete and no longer recognized. Any keys not found in the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]] are not recognized.
__All Puppy packagers are encouraged to use this template for the sake of standardization__. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
Deletions:
The rest of this page explains how to create a //.desktop// file.
Please use the template displayed in the //Appendix// below for the //.desktop// file. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
Once the file is created it needs to be located in this directory:
**/usr/share/applications**
The entries in the file are {key,value} pairs in the format:
**Key=Value**
Note that the "Encoding" key is deprecated, i.e. obsolete and no longer recognized. Any keys not found in the latest freedesktop specification are not recognized.
Keys are either optional or required. The first three {key,value} pairs are required; and the next three are optional but required for a menu icon to appear.
__All Puppy packagers are encouraged to use this template for the sake of standardization__


Revision [4953]

Edited on 2010-01-11 10:36:11 by coolpup
Additions:
Icon=abiword24.png
Icon=
Deletions:
Icon=/usr/local/lib/X11/mini-icons/abiword24.png
Icon=/usr/local/lib/X11/mini-icons/iconfilename24.png


Revision [3679]

Edited on 2009-10-30 12:26:04 by Puppyite
Additions:
{{nocomments}}


Revision [1481]

Edited on 2009-09-25 01:04:50 by coolpup
Additions:
Please use the template displayed in the //Appendix// below for the //.desktop// file. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
Deletions:
Please use this [[http://puppylinux.ca/members/coolpup/APPLICATION.DESKTOP_TEMPLATE.txt template]] for the //.desktop// file.
It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
It is also displayed in the //Appendix// below.


Revision [1480]

Edited on 2009-09-25 01:03:04 by coolpup
Deletions:
====.desktop File====


Revision [1479]

Edited on 2009-09-25 01:02:50 by coolpup
Additions:
Keys are either optional or required. The first three {key,value} pairs are required; and the next three are optional but required for a menu icon to appear.
Deletions:
Keys are either optional or required. That is why the {key,value} pairs have been ordered into 3 groups. The first is required and the rest are optional. The second group will be often used, and the third is used under rare and special circumstances.


Revision [1478]

Edited on 2009-09-25 00:58:49 by coolpup

No Differences

Revision [1464]

Edited on 2009-09-24 21:58:09 by Puppyite
Additions:
For the creation of software packages which __require a menu entry__ perform the following:


Revision [1463]

Edited on 2009-09-24 21:57:57 by Puppyite
Deletions:
For the creation of software packages which __require a menu entry__ perform the following:


Revision [1419]

Edited on 2009-09-24 00:36:33 by coolpup
Additions:
- [[compiling Compile, install, & create a PET software package]]
- Create a //.desktop// file so that the menu will show an entry for that software application
Deletions:
- [[Compiling Compile, install, & create a PET software package]]
- Create a //.desktop// file so that the menu will show an entry for that software application.


Revision [1418]

Edited on 2009-09-24 00:36:03 by coolpup
Additions:
- Create a //.desktop// file so that the menu will show an entry for that software application.
The rest of this page explains how to create a //.desktop// file.
====.desktop File====
Please use this [[http://puppylinux.ca/members/coolpup/APPLICATION.DESKTOP_TEMPLATE.txt template]] for the //.desktop// file.
Comment=word processor
Deletions:
- Create a //*.desktop// file so that the menu will show an entry for that software application.
The rest of this page explains how to create a //*.desktop// file.
====*.desktop File====
Please use this [[http://puppylinux.ca/members/coolpup/APPLICATION.DESKTOP_TEMPLATE.txt template]] for the //*.desktop// file.
Comment=AbiWord word processor


Revision [1084]

Edited on 2009-09-15 15:16:02 by Puppyite [added category]
Additions:
----
==Categories==
CategoryHowTo


Revision [382]

Edited on 2009-08-09 06:41:02 by coolpup [added category]
Additions:
- [[Compiling Compile, install, & create a PET software package]]
Deletions:
- [[Compiling Compile, install, & create a PET in five commands]]


Revision [380]

Edited on 2009-08-09 06:38:35 by coolpup [added category]
Additions:
The rest of this page explains how to create a //*.desktop// file.
Deletions:
The rest of this page explains how to create a //.desktop// file.


Revision [371]

Edited on 2009-08-09 02:25:25 by coolpup [added category]
Additions:
- [[Compiling Compile, install, & create a PET in five commands]]
Deletions:
- [[Compiling Compile, install, & create PET in five commands]]


Revision [370]

Edited on 2009-08-09 02:21:00 by coolpup [added category]
Additions:
#Terminal=true
Deletions:
Terminal=false


Revision [369]

Edited on 2009-08-09 02:18:25 by coolpup [added category]
Additions:
- Create a //*.desktop// file so that the menu will show an entry for that software application.
Deletions:
- Create a //.desktop// file so that the menu will show an entry for that software application.


Revision [368]

Edited on 2009-08-09 02:18:07 by coolpup [added category]
Additions:
====*.desktop File====
Please use this [[http://puppylinux.ca/members/coolpup/APPLICATION.DESKTOP_TEMPLATE.txt template]] for the //*.desktop// file.
Deletions:
====.desktop File====
Please use this [[http://puppylinux.asia/members/coolpup/.desktop/a-application_template.desktop template]] for the //.desktop// file.


Revision [367]

Edited on 2009-08-09 02:15:02 by coolpup [added category]
Additions:
Therefore the //abiword.desktop// file would consist of:
Terminal=false
Deletions:
Therefore the //abiword.desktop// file would be:
#Terminal=true
#Comment=


Revision [366]

Edited on 2009-08-09 02:09:13 by coolpup [added category]
Additions:
- **/usr/share/pixmaps** is for application icons installed from 3rd party PET files and called from ///usr/share/applications/*.desktop files//
The preferred format for __all__ icons, regardless of their purpose, is XPM format. Failing that, PNG is to be preferred. Renaming PNG files with an XPM extension maintains some consistency of naming, if not underlying format.
Deletions:
- **/usr/share/pixmaps** is for application icons installed from 3rd party pet files and called from ///usr/share/applications/*.desktop files//
Icon format is another bone of contention. The preferred format for <u>all</u> icons, regardless of their purpose, is .XPM format. Failing that, .PNG is to be preferred. Renaming .PNG files with an .XPM extension maintains some consistency of naming if not underlying format.


Revision [365]

Edited on 2009-08-09 02:05:47 by coolpup [added category]
Additions:
With regards to PET package creation where should the menu icon files be placed and what size should they be (16x16, 24x24, or 48x48)?
There are necessarily different standard locations for different types of icons.
**/usr/local/libs/X11/mini-icons** is for all of the sub-menu icons and the preferred size is 24x24 although most of the legacy icons are 16x16. These smaller versions will eventually be weeded out as resolutions increase and applications are updated. They were a legacy of early versions of JWM which did n0t support larger menu icons.
- one of 24x24 for the sub-menu (placed in ///usr/local/lib/X11/mini-icons//) and called into the menu from the associated ///usr/share/applications/*.desktop// file
Deletions:
With regards to PET package creation where should the menu icon files be placed and what size should they be (16x16, 24x24, or 48x48)?<br />
There are necessarily different standard locations for different types of icons. <br />
**/usr/local/libs/X11/mini-icons** is for all of the sub-menu icons and the preferred size is 24x24 although most of the legacy icons are 16x16. These smaller versions will eventually be weeded out as resolutions increase and applications are updated. They were a legacy of early versions of JWM which didn't support larger menu icons.
- one of 24x24 for the sub-menu (placed in <i>/usr/local/lib/X11/mini-icons</i>) and called into the menu from the associated <i>/usr/share/applications/*.desktop</i> file


Revision [322]

Edited on 2009-08-08 08:38:35 by coolpup [added category]
Additions:
Please use this [[http://puppylinux.asia/members/coolpup/.desktop/a-application_template.desktop template]] for the //.desktop// file.
It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]].
It is also displayed in the //Appendix// below.
Deletions:
Please use this [[http://puppylinux.asia/members/coolpup/.desktop/a-application_template.desktop template]] for the //.desktop// file. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]]. It is also displayed in the //Appendix// below.


Revision [321]

Edited on 2009-08-08 08:37:52 by coolpup [added category]
Additions:
The PET software package should contain not one but __two__ icons:
Deletions:
The puppy dotpet file should contain not one but <u>two</u> icons:


Revision [320]

Edited on 2009-08-08 08:36:03 by coolpup [added category]
Additions:
Other optional keys are available which are seldom used:


Revision [319]

Edited on 2009-08-08 08:33:35 by coolpup [added category]
Additions:
- [[Compiling Compile, install, & create PET in five commands]]
**/usr/share/applications**
**Key=Value**
Note that the "Encoding" key is deprecated, i.e. obsolete and no longer recognized. Any keys not found in the latest freedesktop specification are not recognized.
With regards to PET package creation where should the menu icon files be placed and what size should they be (16x16, 24x24, or 48x48)?<br />
Therefore the //abiword.desktop// file would be:
%%(language-ref)
Desktop Entry]
%%
__All Puppy packagers are encouraged to use this template for the sake of standardization__
%%(language-ref)
%%
Deletions:
- [[Compiling Compile, install, & create .PET in five commands]]
<code>
/usr/share/applications
</code>
<code>
Key=Value
</code>
Note that the <code>Encoding</code> key is deprecated, i.e. obsolete and no longer recognized. Any keys not found in the latest freedesktop specification are not recognized.
With regards to .PET package creation where should the menu icon files be placed and what size should they be (16x16, 24x24, or 48x48)?<br />
Therefore the <i>abiword.desktop</i> file would be:
<code>
</code>
<u>All Puppy packagers are encouraged to use this template for the sake of standardization.</u>
<code>
</code>


Revision [225]

Edited on 2009-08-04 00:53:52 by coolpup [added category]
Additions:
- [[Compiling Compile, install, & create .PET in five commands]]
- Create a //.desktop// file so that the menu will show an entry for that software application.
The rest of this page explains how to create a //.desktop// file.
Deletions:
- <li><a href="/wiki/compiling">Compile, install, & create .PET in five commands</a>
- <li>Create a <i>.desktop</i> file so that the menu will show an entry for that software application.
The rest of this page explains how to create a <i>.desktop</i> file.


Revision [224]

Edited on 2009-08-04 00:52:40 by coolpup [added category]
Additions:
For the creation of software packages which __require a menu entry__ perform the following:

- <li><a href="/wiki/compiling">Compile, install, & create .PET in five commands</a>
- <li>Create a <i>.desktop</i> file so that the menu will show an entry for that software application.


====.desktop File====
Please use this [[http://puppylinux.asia/members/coolpup/.desktop/a-application_template.desktop template]] for the //.desktop// file. It adheres to the [[http://standards.freedesktop.org/desktop-entry-spec/latest/index.html latest freedesktop specification]]. It is also displayed in the //Appendix// below.



====Menu and Desktop Icons====


**/usr/local/libs/X11/mini-icons** is for all of the sub-menu icons and the preferred size is 24x24 although most of the legacy icons are 16x16. These smaller versions will eventually be weeded out as resolutions increase and applications are updated. They were a legacy of early versions of JWM which didn't support larger menu icons.

**/usr/local/libs/X11/pixmaps** is only for the desktop icons that are part of the packaged desktop themes and their associated icons for the 1st level menus. For desktop icons the preferred size is 48x48. For 1st level menu icons the preferred size is 24x24. We also need to standardise on a given set of icons that constitutes a desktop theme. Some themes call icons by one name, others by another. That causes many problems. We are keen to ensure that /usr/local/libs/X11/pixmaps is kept exclusively for those icons that are used in the pinboard and 1st level menus. That is because that is what Barry's desktop icon switcher uses. We insist that only desktop theme icons go in /usr/local/lib/X11/pixmaps where they are regularly overwritten by themes from the /usr/local/libs/X11/themes directories.

Legacy locations from other Linux distributions (Debian, Red Hat, etc.) [We would like to be able to do away with them but the first converted .DEB or .RPM application that installs will place its own icons in there anyway.]

- **/usr/share/icons** is for application icons installed from 3rd party pet files and called from ///usr/share/applications/*.desktop files//

- **/usr/share/pixmaps** is for application icons installed from 3rd party pet files and called from ///usr/share/applications/*.desktop files//


- one of 24x24 for the sub-menu (placed in <i>/usr/local/lib/X11/mini-icons</i>) and called into the menu from the associated <i>/usr/share/applications/*.desktop</i> file
- one of 48x48 for use with a desktop shortcut if the user creates one; the latter icon should be placed in either /usr/share/pixmaps or /usr/share/icons - /usr/share/pixmaps is preferred


====Appendix====



Deletions:
For the creation of software packages which <u>require a menu entry</u> perform the following:
<br />
<li><a href="/wiki/compiling">Compile, install, & create .PET in five commands</a></li>
<li>Create a <i>.desktop</i> file so that the menu will show an entry for that software application.</li>
<br />
<br />
<h3>.desktop File</h3>
Please use this <a href="http://puppylinux.asia/members/coolpup/.desktop/a-application_template.desktop">template</a> for the <i>.desktop</i> file. It adheres to the <a href="http://standards.freedesktop.org/desktop-entry-spec/latest/index.html">latest freedesktop specification</a>. It is also displayed in the <i>Appendix</i> below.
<br />
<br />
<br />
<h3>Menu and Desktop Icons</h3>
<br />
<br />
<b>/usr/local/libs/X11/mini-icons</b> is for all of the sub-menu icons and the preferred size is 24x24 although most of the legacy icons are 16x16. These smaller versions will eventually be weeded out as resolutions increase and applications are updated. They were a legacy of early versions of JWM which didn't support larger menu icons. <br />
<br />
<b>/usr/local/libs/X11/pixmaps</b> is only for the desktop icons that are part of the packaged desktop themes and their associated icons for the 1st level menus. For desktop icons the preferred size is 48x48. For 1st level menu icons the preferred size is 24x24. We also need to standardise on a given set of icons that constitutes a desktop theme. Some themes call icons by one name, others by another. That causes many problems. We are keen to ensure that /usr/local/libs/X11/pixmaps is kept exclusively for those icons that are used in the pinboard and 1st level menus. That is because that is what Barry's desktop icon switcher uses. We insist that only desktop theme icons go in /usr/local/lib/X11/pixmaps where they are regularly overwritten by themes from the /usr/local/libs/X11/themes directories.<br />
<br />
Legacy locations from other Linux distributions (Debian, Red Hat, etc.) [We would like to be able to do away with them but the first converted .DEB or .RPM application that installs will place its own icons in there anyway.]<br />
<li><b>/usr/share/icons</b> is for application icons installed from 3rd party pet files and called from <i>/usr/share/applications/*.desktop files</i></li> <br />
<li><b>/usr/share/pixmaps</b> is for application icons installed from 3rd party pet files and called from <i>/usr/share/applications/*.desktop files</i></li>
<br />
<br />
<br />
<br />
<li>one of 24x24 for the sub-menu (placed in <i>/usr/local/lib/X11/mini-icons</i>) and called into the menu from the associated <i>/usr/share/applications/*.desktop</i> file</li> <br />
<li>one of 48x48 for use with a desktop shortcut if the user creates one; the latter icon should be placed in either /usr/share/pixmaps or /usr/share/icons - /usr/share/pixmaps is preferred</li>
<br />
<br />
<h3>Appendix</h3>
<br />
<br />
<br />
<br />


Revision [156]

The oldest known version of this page was created on 2009-08-02 00:20:58 by coolpup [added category]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki