[HTML SKIN] Guide for YAMJ skin makers

[Omertron]

I've just completed issue 435 to add some new skin parameters.

These are:

Code:

thumbnails.reflectionHeight
thumbnails.perspectiveTop
thumbnails.perspectiveBottom
thumbnails.perspectiveDirection
posters.reflectionHeight
posters.perspectiveTop
posters.perspectiveBottom
posters.perspectiveDirection

reflectionHeight controls how much of the poster to reflect, default (as now) is 12.5%

pespectiveTop & pespectiveBottom control the percentage that the corners dip to give the perspective view. Default is 3%

perspectiveDirection is one of "left", "right", "both". Left and Right are the sides that the perspective is applied. "Both" allows you to create a mirror thumbnail (named xxx_small_mirror.png or xxx_large_mirror.png) which is the left hand mirror of the other side if you see what I mean.

Hopefully these new properties will give you some more options around the skins

[Omertron]

Just finished Issue 397
New skin property: mjb.includeVideoImages. If this is true, then episode images from TheTVDB.com are downloaded and stored in the Jukebox folder.
New attribute is added to the files tags in the xmls :

Code:

<fileImage part="1">basename_VideoImage_1.jpg</fileImage>

New skin resource: dummy_videoimage.jpg used when there is not video image.

Note: Nothing is retrieved for Movies, so the dummy image is used.

[curien]

I just made another change that skin authors should be aware of. As of r839, there is a new overlay, set.png (reference implementation available in the default skin), which can be used to identify posters for sets. See issue 574: http://code.google.com/p/moviejukebox/is...ail?id=574 .

[curien]

r845 includes another change that might require some skin modifications.

The Categories.xml file used to assume that the name of an index could be used verbatim in the filename for that index. With the new encoding scheme, that's not necessarily the case (especially since which characters get encoded is at the mercy of the user ).

So, I changed the tag to be a little different. If mjb.includeMoviesInCategories is false, the index tag works just like in the movie XML files -- the "name" attribute is the display name, and the inner text is the (encoded) filename of the first page for the index.

If mjb.includeMoviesInCategories is true, there are two attributes: "name" as before, and "filename", which is the (encoded) filename for the first page of the index.

You can take a look at the categories.xsl in the default skin for a reference, of course.

[Omertron]

(03-15-2009 12:13 PM)Omertron Wrote:  Just finished Issue 397
New skin property: mjb.includeVideoImages. If this is true, then episode images from TheTVDB.com are downloaded and stored in the Jukebox folder.
New attribute is added to the files tags in the xmls :

Code:

<fileImage part="1">basename_VideoImage_1.jpg</fileImage>

New skin resource: dummy_videoimage.jpg used when there is not video image.

Note: Nothing is retrieved for Movies, so the dummy image is used.

After some reports from Excal that this wasn't working exactly as planned, I've updated the code.
Now there are two attributes created, similar to posters and fanart.

Code:

<fileImageURL part="1">http://somesite.com/12345.jpg</fileImage><fileImageFile part="1">basename_VideoImage_1.jpg</fileImage>

[curien]

In r886, I've added a new skin property, mjb.sets.createPosters. It defaults to false, but if you set it to true, YAMJ will create posters (*_large.png files) for the set masters.

Excal, do you think it would be useful to make this thread sticky?

[garp99]

I should point out to skinners that Issue 678 was fixed (recognize season = 0 as specials).

To those that have their created their own skin, please be sure to check your
index.xsl and details.xsl files for testing movie vs TV show

For Movies, use
season = -1

For TV shows, use
season != -1
or
season >= 0

Edit: My bad typo! Yes, both cases should check against -1 :slap:

[Omertron]

Issue 683 has been fixed in r893.
There are two new properties for skins:
videoimages.width and videoimages.height which will scale the video images to those dimensions. These default to 400 and 225 respectively.

EDITED: Please note that the property is videoimages with an "S" at the end

[Omertron]

I've committed the requested reflection changes. There are four new properties for skins:

• reflectionStart
• reflectionEnd
• opacityStart
• opacityEnd
  

The first two control where the reflection gradient starts and ends on the reflection portion of the image. 0% is the start of the reflection and 100% is the end of the reflection.

The next two control the start and end values of the opacity of the reflection gradient ranging from 0% (clear) to 100% (opaque or black).

[curien]

As of r906, there is a new set of categories -- index by library description.

[curien]

A new feature has been added (issue 226) to make it possible to link from the movie details page to various indexes. The xml for director now sometimes has an "index" attribute:

Code:

<director index="Director_Robert%20Zemeckis_1">Robert Zemeckis</director>

You can then take advantage of that to link to a list of other movies directed by the same person:

Code:

<xsl:if test="director != 'UNKNOWN'">
              <xsl:choose>
                <xsl:when test="director/@index != ''">
                  <a>
                    <xsl:attribute name="href"><xsl:value-of select="director/@index" />.html</xsl:attribute>
                    <xsl:value-of select="director" />
                  </a>
                </xsl:when>
                <xsl:otherwise>
                  <xsl:value-of select="director" />
                </xsl:otherwise>
              </xsl:choose>
            </xsl:if>

Director, Cast, (for s), and Country are the new indexes currently, with others on the way. Genres also uses the index attribute now (which is necessary since a filtered genre's index page is not named like its value).

[garp99]

To add to Curien's post above, there are also new options in the moviejukebox.properties file
After this line (around 140)

Code:

# Only replace set movies for the set master if all movies appear in a category
mjb.sets.requireAll=false

add the following...

Code:

# Comma-separated list of indexes to generate. Valid indexes include:
#  Other, Genres, Title, Rating, Year, Library, Cast, Director, and Country
mjb.categories.indexList=Other,Genres,Title,Rating,Year,Library,Set

# Comma-separated list of indexes to display on the categories page.
# If blank or undefined, all categories listed in the indexList are shown.
mjb.categories.displayList=

# Minimum number of movies in an index before it shows on the categories page
mjb.categories.minCategoryCount=3

[Omertron]

Committed the code for Issue 701 so now all of the same properties of thumbnails and posters can be applied to video images as well. I'm sure someone will find a use for reflective videoimages

[curien]

r960 includes the skin.clean.skip property in the skin config file, which is a regex for files to skip during cleaning.

Edit: As of r964, the property was renamed to mjb.clean.skip. Apparently skin.* properties will be reserved for things that affect only HTML generation via XSLT.

[garp99]

Thanks Curien.

As of r957, the YAMJ skins: default, sd, gfb107 and gfb107-sd now have a new file called skin-options.xsl which contain
options that are related to the skin output of the HTML files, and not based on YAMJ needing those options when you run YAMJ.
Making a change in this new file means that only the HTML files will need to be re-created, not the XML metafiles.

Currently, the options added for the index pages is to enable/disable what shows after the Title display when you hover
over a movie cover. This includes the Year (option for movie and TV), and the Certification rating (ex: PG-13).

For the detail pages, the parameter skin.reverseEpisodeOrder has been moved into this file since it only affects the HTML output.
New values for the location of the PLAY ALL link, either "top" or "bottom" (option for movie and TV),
as well as the text to use for the link, which defaults to "PLAY ALL".

If you have any other requests for custom options, create an issue...
anything posted here will be ignored