Xargon/ES-DE
1
0
Fork 0
mirror of https://github.com/RetroDECK/ES-DE.git synced 2024-11-22 06:05:38 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Fixed some formatting.

Browse source
This commit is contained in:
Aloshi 2014-01-19 19:12:52 -06:00
parent 45592544c1
commit 9a9ec3d855
1 changed files with 21 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
THEMES.md
View file

@ -9,7 +9,7 @@ Simple Example
Here is a very simple theme that changes the description text's color: Here is a very simple theme that changes the description text's color:
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<view name="detailed"> <view name="detailed">
@ -37,7 +37,7 @@ Everything must be inside a `<theme>` tag.
A *view* can be thought of as a particular "screen" within EmulationStation. Views are defined like this: A *view* can be thought of as a particular "screen" within EmulationStation. Views are defined like this:
``` ```xml
<view name="ViewNameHere"> <view name="ViewNameHere">
... define elements here ... ... define elements here ...
</view> </view>
@ -47,7 +47,7 @@ A *view* can be thought of as a particular "screen" within EmulationStation. Vi
An *element* is a particular visual element, such as an image or a piece of text. You can either modify an element that already exists for a particular view (as is done in the "description" example), like this: An *element* is a particular visual element, such as an image or a piece of text. You can either modify an element that already exists for a particular view (as is done in the "description" example), like this:
``` ```xml
<elementTypeHere name="ExistingElementNameHere"> <elementTypeHere name="ExistingElementNameHere">
... define properties here ... ... define properties here ...
</elementTypeHere> </elementTypeHere>
@ -55,7 +55,7 @@ An *element* is a particular visual element, such as an image or a piece of text
Or, you can create your own elements by adding `extra="true"` (as is done in the "my_image" example) like this: Or, you can create your own elements by adding `extra="true"` (as is done in the "my_image" example) like this:
``` ```xml
<elementTypeHere name="YourUniqueElementNameHere" extra="true"> <elementTypeHere name="YourUniqueElementNameHere" extra="true">
... define properties here ... ... define properties here ...
</elementTypeHere> </elementTypeHere>
@ -67,7 +67,7 @@ Or, you can create your own elements by adding `extra="true"` (as is done in the
*Properties* control how a particular *element* looks - for example, its position, size, image path, etc. There different types of properties that determine what kinds of values you can use - you can read about them below in the "Reference" section. Properties are defined like this: *Properties* control how a particular *element* looks - for example, its position, size, image path, etc. There different types of properties that determine what kinds of values you can use - you can read about them below in the "Reference" section. Properties are defined like this:
``` ```xml
<propertyNameHere>ValueHere</propertyNameHere> <propertyNameHere>ValueHere</propertyNameHere>
``` ```
@ -84,7 +84,7 @@ It is recommended that if you are writing a theme you launch EmulationStation wi
You can include theme files within theme files, similar to `#include` in C (though the mechanism is different, the effect is the same). Example: You can include theme files within theme files, similar to `#include` in C (though the mechanism is different, the effect is the same). Example:
`~/.emulationstation/all_themes.xml`: `~/.emulationstation/all_themes.xml`:
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<view name="detailed"> <view name="detailed">
@ -97,7 +97,7 @@ You can include theme files within theme files, similar to `#include` in C (thou
``` ```
`~/.emulationstation/snes/theme.xml`: `~/.emulationstation/snes/theme.xml`:
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<include>./../all_themes.xml</include> <include>./../all_themes.xml</include>
@ -110,7 +110,7 @@ You can include theme files within theme files, similar to `#include` in C (thou
``` ```
Is equivalent to this `snes/theme.xml`: Is equivalent to this `snes/theme.xml`:
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<view name="detailed"> <view name="detailed">
@ -130,7 +130,7 @@ Notice that properties that were not specified got merged (`<fontPath>`) and the
Sometimes you want to apply the same values to the same element across many views. The "common" view is one way to do this. Sometimes you want to apply the same values to the same element across many views. The "common" view is one way to do this.
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<view name="common"> <view name="common">
@ -147,7 +147,7 @@ Sometimes you want to apply the same values to the same element across many view
``` ```
Is equivalent to: Is equivalent to:
``` ```xml
<theme> <theme>
<version>3</version> <version>3</version>
<view name="basic"> <view name="basic">
@ -221,25 +221,25 @@ Reference
* All values will follow to the right of their labels if a position isn't specified. * All values will follow to the right of their labels if a position isn't specified.
* `image name="md_image"` - POSITION | SIZE * `image name="md_image"` - POSITION | SIZE
- Path is the `image` metadata for the currently selected game. - Path is the "image" metadata for the currently selected game.
* `rating name="md_rating"` - ALL * `rating name="md_rating"` - ALL
- The `rating` metadata. - The "rating" metadata.
* `datetime name="md_releasedate"` - ALL * `datetime name="md_releasedate"` - ALL
- The `releasedate` metadata. - The "releasedate" metadata.
* `text name="md_developer"` - ALL * `text name="md_developer"` - ALL
- The `developer` metadata. - The "developer" metadata.
* `text name="md_publisher"` - ALL * `text name="md_publisher"` - ALL
- The `publisher` metadata. - The "publisher" metadata.
* `text name="md_genre"` - ALL * `text name="md_genre"` - ALL
- The `genre` metadata. - The "genre" metadata.
* `text name="md_players"` - ALL * `text name="md_players"` - ALL
- The `players` metadata (number of players the game supports). - The "players" metadata (number of players the game supports).
* `datetime name="md_lastplayed"` - ALL * `datetime name="md_lastplayed"` - ALL
- The `lastplayed` metadata. Displayed as a string representing the time relative to "now" (e.g. "3 hours ago"). - The "lastplayed" metadata. Displayed as a string representing the time relative to "now" (e.g. "3 hours ago").
* `text name="md_playcount"` - ALL * `text name="md_playcount"` - ALL
- The `playcount` metadata (number of times the game has been played). - The "playcount" metadata (number of times the game has been played).
* `text name="md_description"` - POSITION | SIZE | FONT_PATH | FONT_SIZE | COLOR * `text name="md_description"` - POSITION | SIZE | FONT_PATH | FONT_SIZE | COLOR
- Text is the `desc` metadata. If no `pos`/`size` is specified, will move and resize to fit under the lowest label and reach to the bottom of the screen. - Text is the "desc" metadata. If no `pos`/`size` is specified, will move and resize to fit under the lowest label and reach to the bottom of the screen.
--- ---
@ -368,6 +368,7 @@ EmulationStation borrows the concept of "nine patches" from Android (or "9-Slice
*Note that a view may choose to only make only certain properties on a particular element themable!* *Note that a view may choose to only make only certain properties on a particular element themable!*
[*Check out the "official" themes for some more examples!*](http://aloshi.com/emulationstation#themes)
-Aloshi -Aloshi
http://www.aloshi.com http://www.aloshi.com