Pathnames

1. Introduction

Well-Known Pathnames

/.well-known/

It is increasingly common for Web-based protocols to require the discovery of policy or other information about a host (“site-wide metadata”) before making a request. RFC5785 defines a path prefix in HTTP(S) URIs for these “well-known locations”, “/.well-known/”.

Specifications that need to define a resource for such site-wide metadata can register their use with Internet Assigned Numbers Authority (IANA) to avoid collisions and minimize impingement upon sites' URI space.

A well-known URI is a URI RFC3986 whose path component begins with the characters “/.well-known/”, and whose scheme is “HTTP”, “HTTPS”, or another scheme that has explicitly been specified to use well-known URIs.

For example, if an application registers the name “example”, the corresponding well-known URI on “http://www.example.com/” would be “http://www.example.com/.well-known/example”.

/cgi-bin/

/NS/ Namespace URI's

{ Capital letters.}

{ Link will lead to the specification, either directly or via redirect. }

/uri-res/ URI Resolver

Web Design (UX) Components

/QR*

/data/

/embed/

/font/

/img/

backgrounds/

badges/

emotes/

flags/

“WxH.extension” for bitmapped image formats, or “scalable.extension” for vector image formats. The Klingon language flag in scalable vector graphics format would thus be located in “/img/flags/languages/tlh/scalable.svg”

/img/flags/XX/

The flag for the country with the ISO 3166-1 country code XX. All flags should use ISO 3166-1 alpha2 country codes, in lowercase form, as the specifier for the country.

/img/flags/languages/XX/

The flag for the language with the ISO 639-2 language code XX. All flags should use ISO 639-2 alpha2, alpha3 or bibliographic language codes, in lowercase form, as the specifier for the language.

/img/flags/org/

icons/

{ Using the same directory structure as the Freedesktop.org specification allows the use of icon themes for the GNU Linux' X Window system. /// }

<theme>/<size>/actions/

Icons which are generally used in menus and dialogs for interacting with the user.

<theme>/<size>/animations/

Animated images used to represent loading web sites, or other background processing which may be less suited to more verbose progress reporting in the user interface. Animations should be a PNG with frames which are the size of the directory the animation is in, tiled in a W×H grid. Implementations should determine the number of frames by dividing the image into its frames, and iterating from left to right, wrapping to the first frame, after rendering the last.

<theme>/<size>/apps/

Icons that describe what an application is, for use in the Programs menu, window decorations, and the task list. These may or may not be generic depending on the application and its purpose. Applications which are to be considered part of the base desktop, such as the calculator or terminal, should use the generic icons specified in this specification, while more advanced applications such as web browsers and office applications should use branded icons which still give the user an idea of what function the application provides.

<theme>/<size>/categories/

Icons that are used for categories in the Programs menu, or the Control Center, for separating applications, preferences, and settings for display to the user.

<theme>/<size>/devices/

Icons for hardware that is contained within or connected to the computing device. Naming for extended devices in this group, is of the form <primary function>-<manufacturer>-<model>. This allows ease of fallback to the primary function device name, or ones more targeted for a specific series of models from a manufacturer. For example, a theme author may want to provide icons for different phones. The specific model icons could be named “phone-samsung-t809”, “phone-motorola-rokr”, and “phone-motorola-pebl”. However, the theme must provide a phone icon in the theme's style, so that devices not matching these models, will still have an appropriate icon. An exception to this rule is that the “media” icons do not need to include manufacturer names, as they are generic items, and may be available from many manufacturers. As a result, for media, the specific icons are to differentiate between different specific types of media. For exmaple, an artist may wish to provide icons for BluRay, DVD, HD-DVD, CD-ROM, and variations thereof. The specific media type icons should be named in the form, <primary function>-<specific format>. Some examples are “media-optical”, “media-optical-bd” and “media-optical-dvd”.

<theme>/<size>/emblems/

Icons for tags and properties of files, that are displayed in the file manager. This context contains emblems for such things as “read-only” or “photos”.

<theme>/<size>/emotes/

Icons for emotions that are expressed through text chat applications such as :-) or :-P in IRC or instant messengers.

<theme>/<size>/filesystems/
<theme>/<size>/intl/

Icons for international denominations such as flags.

flag-XX.*:
The flag for the country with the ISO 3166-1 country code XX. All flags should use ISO 3166-1 alpha2 country codes, in lowercase form, as the specifier for the country.
lang-XX.*:
The flag for the language with the ISO 639-2 language code XX. All flags should use ISO 639-2 alpha2, alpha3 or bibliographic language codes, in lowercase form, as the specifier for the language.
<theme>/<size>/mimetypes/

Icons for different types of data, such as audio or image files.

<theme>/<size>/places/

Icons used to represent locations, either on the local filesystem, or through remote connections. Folders, trash, and workgroups are some examples.

<theme>/<size>/status/

Icons for presenting status to the user. This context contains icons for warning and error dialogs, as well as for the current weather, appointment alarms, and battery status.

<theme>/<size>/stock/

logos/

example.org would be found in /img/logos/org/example/

/object/

 

i18n/

 

countries/

 

languages/

 

/script/

The contents of this directory tree is described in more detail in /script/index.phtml.

/style/

The contents of this directory tree is described in more detail in /style/index.phtml.

Media

/audio/

/picture/

/video/


References and Further Reading