Mars 30 User's Manual
Layout » Pages
Layout » Pages » Titles
- Index page title: The title bar on the index pages can be set to display the album title, the folder title (at the top level, this is same as the album title), or nothing.
- Include description: If selected, the album or folder description is displayed below the album title or folder title.
- Show folder title in browser tab: If selected, index pages within a folder will show the folder title in the browser tab. Otherwise, the album title is displayed in the browser tab on all pages.
- Display underscores as spaces: If selected, underscores in folder and file names that appear as titles, browser tabs, or captions are displayed as spaces. This applies only to the actual folder and file names. User-entered titles and comments are not affected. The folder and file names themselves are not changed.
Layout » Pages » Navigation
- Site Home and Album Home: If you choose the first icon set, the "leaving this page" icon is used for links in the album that point to the homepage you have entered under Album » Settings » Pages » Link to external homepage » Address (URL), if any, and the "house" icon is used for links from folders in the album that point to the top level of the album, if you have chosen to display such links. If you choose the second set, the "house" icon is used for the homepage link, and the "double up" icon is used for returning to the top of the album from folders.
- Link to album home: If selected, index page navigation at all levels below the top level of the album includes a "home" icon that takes the site visitor back to the main index page of the album.
- Fullscreen option: If selected, a fullscreen toggle icon is displayed in the title bar. Note that when a visitor enters a folder in the album, the display reverts to the regular, non-fullscreen view. This is a browser security measure, and can't be overridden.
- Open web locations in new tab: If selected, web locations will open in a new browser tab, rather than the same browser tab.
Layout » Pages » Slides
- Caption content: The caption may display the image title, the image comment, both, or neither.
- Name if no title: If no image title has been entered, use the image file name (without its extension).
- Padding width: For the slide image, you may select the width of the padding around the image.
- Shadow opacity: If the slide image padding width is greater than zero, you may choose to include a box shadow on the slide image. Opacity of zero means no shadow, with higher values representing a denser shadow.
- Arrows off-image: If selected, the "previous" and "next" arrows on the slides are shown at the edges of the viewport, rather than on the image.
- Border: A border can be applied to the entire lightbox. In most cases this is unnecessary. However, if you are using the "dark" style, or a custom style with a very dark slide background, a thin border around the lightbox can separate it from the dimming background.
- Loop slides: If selected, clicking the "next" arrow on the last slide takes the visitor to the first slide, and clicking the "previous" arrow on the first slide takes the visitor to the last slide.
Layout » Pages » Theme Image
- Parallax theme image / Fixed theme image / No theme image: These radio buttons control which type of theme image will be used. A parallax theme image is large and scrollable, producing the illusion of page depth. A fixed theme image is a constant height. If no theme image is chosen, the title bar is a simple colored bar.
- Height (%): The minimum height of the theme image that will be visible, expressed as a percentage of the viewport width, if a parallax theme image is selected. Be aware that the theme image is actually used as a background image that covers the entire viewport - the page content then masks off the lower portion of the theme image. When choosing a theme image, it should be an image whose desired content occurs towards the top of the image, rather than in the center, since the center will be obscured by the page content unless a fairly high value is chosen for the theme image display height, like 50%.
- Height (px): The height of the theme image, if a fixed theme image is selected.
- Use...: These radio buttons control whether each folder will show its own theme image, or whether each folder will show the top-level theme image, or whether the theme image will be shown only at the top level of the album. In this last case, folders will display an ordinary title area, without any theme image.
- Full page: If selected, the theme image is displayed over the entire viewport. It is non-parallax and a fixed height.
- Border: If selected, a one-pixel border is shown on the bottom edge of the theme image.
Layout » Thumbnails
Layout » Thumbnails » Layout
- Max table width: The maximum width of the thumbnail table. If the viewport width is less than this, the thumbnail table is adjusted to fit.
- Borders: If selected, a one-pixel border is shown on the thumbnails.
- Folders last: If selected, the grouped folder thumbnails on a page are shown after the image thumbnails, rather than before. This may be applied only to a specific folder or folders. If you want only the subfolders in Folder A to appear at the bottom of the page for Folder A, do not select Folders last on the settings here. Instead, hover on the Folder A thumbnail in the jAlbum Explore view, and choose More..., then Edit. On the right, expand the Variables panel and enter a variable called locFoldersLast, with a value of true.
Layout » Thumbnails » Folders
- Thumbnail spacing: The spacing between folder thumbnails.
- Fixed shape: The folder thumbnails may be cropped to a fixed shape. If this option is selected, folder thumbnail captions, if any, are shown below the thumbnails. Otherwise, captions are shown as overlays on the thumbnail when the site visitor hovers his mouse on the thumbnail. If fixed shape thumbnails are not selected, the aspect ratio (width divided by height) of each thumbnail will be the same as that of the original image, but restricted to a minimum of 0.5 and a maximum of 2.5. This prevents panoramic images and unusually tall, skinny images from producing thumbnails with extreme aspect ratios, which otherwise tend to disrupt the thumbnail table layout.
- Captions always visible: If selected, captions are always visible, rather than being visible only when the visitor hovers his mouse on the thumbnail.
- Thumbnail height: Folder thumbnails may be shown with a height between 50% and 200% of the image thumbnail size.
- Aspect ratio: If folder thumbnails are cropped to a fixed shape, you may choose the aspect ratio (width:height), with 1:1 being square thumbnails.
Layout » Thumbnails » Images
- Thumbnail spacing: The spacing between thumbnails.
- Fixed shape: If selected, thumbnails are cropped to the dimensions chosen under Album » Settings » Images » Image Bounds » Thumbnails. If this option is selected, thumbnail captions, if any, are shown below the thumbnails. Otherwise, captions are shown as overlays on the thumbnail when the site visitor hovers his mouse on the thumbnail. If fixed shape thumbnails are not selected, the aspect ratio (width divided by height) of each thumbnail will be the same as that of the original image, but restricted to a minimum of 0.5 and a maximum of 2.5. This prevents panoramic images and unusually tall, skinny images from producing thumbnails with extreme aspect ratios, which otherwise tend to disrupt the thumbnail table layout.
- Captions always visible: If selected, captions are always visible, rather than being visible only when the visitor hovers his mouse on the thumbnail.
Layout » » Thumbnails » Overlays
- Overlay on video thumbnails: If selected, a semi-transparent overlay is placed on video thumbnails, including YouTube and Vimeo videos.
- Size: The size of the video overlay, as a percentage of the thumbnail image bounds. For example, if the thumbnail image bounds are 300x200, and the size is 67%, the overlay will be 134px (200 * 0.67).
- Overlay on web location thumbnails: If selected, a semi-transparent overlay is placed on web location thumbnails.
- Size: The size of the web location overlay, as a percentage of the thumbnail image bounds. For example, if the thumbnail image bounds are 300x200, and the size is 67%, the overlay will be 134px (200 * 0.67).
Layout » Thumbnails » Captions
- Folder thumbnail caption: The caption for a folder thumbnail may display the folder title, the folder comment, both, or neither.
- Name if no title: If no folder title has been entered, use the folder name.
- Image thumbnail caption: The caption below an image thumbnail may display the image title, the image comment, both, or neither.
- Name if no title: If no image title has been entered, use the image file name (without its extension).
Fonts » Album
Fonts » Album » Font Family
- Font family: The font family for the album. Each font family is designed to be fairly "web-safe," and produces a font stack in the album's CSS that will provide acceptable results on most site visitors' computers. The font stacks produced by each font family choice are as follow:
- Arial: Arial, "Helvetica Neue", Helvetica, sans-serif
- Brush Script: "Brush Script MT", cursive
- Comic Sans: "Comic Sans", "Comic Sans MS", "Chalkboard", "ChalkboardSE-Regular", "Marker Felt", "Purisa", "URW Chancery L", cursive
- Courier: "Courier New", Courier, "Lucida Sans Typewriter", "Lucida Typewriter", monospace
- Georgia: Georgia, Times, "Times New Roman", serif
- Palatino: Palatino, "Palatino Linotype", "Palatino LT STD", "Book Antiqua", Georgia, serif
- Papyrus: Papyrus, fantasy
- Tahoma: Tahoma, Verdana, Segoe, sans-serif
- Times New Roman: TimesNewRoman, "Times New Roman", Times, Baskerville, Georgia, serif
- Trebuchet: "Trebuchet MS", "Lucida Grande", "Lucida Sans Unicode", "Lucida Sans", Tahoma, sans-serif
- Verdana: Verdana, Geneva, sans-serif
- Apply to All: Click this button to apply the selected Font family to all text fields in the album.
Fonts » Album » Google Font
Fonts » Album » WOFF File
Fonts » Index Page
Fonts » Index Page » Font Styles
- Theme image title: The font styles for the page title shown on the theme image on index and info pages. The font size may be set to zero, meaning that the title is not displayed. This option might be chosen if the theme image contains its own text or a large logo.
- Theme image description: The font styles for the page description shown on the theme image on index pages. The font size may be set to zero.
- Banner title: The font styles for the album or folder title shown on a banner.
- Banner description: The font styles for the album or folder description (folder comment) shown on a banner.
- Folder thumbnail title: The font styles for the folder thumbnail title(s) on index pages.
- Folder thumbnail comment: The font styles for the folder thumbnail comment(s) on index pages.
- Image thumbnail title: The font styles for the image thumbnail title(s) on index pages.
- Image thumbnail comment: The font styles for the image thumbnail comment(s) on index pages.
- Top info: The font styles for Top Info text on index pages.
- Bottom info: The font styles for Bottom Info text on index pages.
- Copyright: The font styles for the copyright notice on index pages.
Fonts » Slides & Info Page
Fonts » Slides & Info Page » Slides Font Styles
- Image title: The font styles for the image title on slides.
- Image comment: The font styles for the image comment on slides.
Fonts » Slides & Info Page » Info Page Font Styles
- Title: The font styles for the title on the info page.
- Text: The font styles for the text on the info page.
- Contact: The font styles for the contact line on the info page.
Text » Tooltips
- Site home: If a URL and text are entered under Album » Settings » Pages » Link to external homepage, this is the icon that will appear on each index page. The tooltip that appears when a visitor hovers on this icon is entered on that settings page, rather than here. This is intended for a home page that is external to the album.
- Album home: The tooltip that appears when a visitor hovers on the "album home" icon.
- Up one level: The tooltip that appears when a visitor hovers on the "up one level" icon.
- Fullscreen: The tooltip that appears when a visitor hovers on the "fullscreen" icon.
- Info page: The tooltip that appears when a visitor hovers on the "info page" icon.
- Index page: The tooltip that appears when a visitor hovers on the "index page" icon on an info page.
Info Page » General
Info Page » General » Layout
- Match width of index page: If selected, the info page will be the same width as the top-level index page.
- Page width: The width of the info page. Used to produce an info page display that's narrower than the index page, though the title bar remains the same width. If larger than the actual width of the index page, this value is ignored.
- Link on top level only: If selected, the link to the info page will appear only on the index page for the top level of the album. If not selected, the link will appear on all index pages.
- Border: If selected, a one-pixel border is shown on the info page.
Info Page » General » Image
- Add / Remove: Click Add to select an image to display on the info page. Click Remove to remove the image.
- File: This field displays the name of the chosen file, but cannot be directly edited. To change the image, remove the existing one and add a new one.
- Image width: The width of the image. The image will be scaled down to this width - the image will not be shown larger than it actually is, however.
- Location: The image may be positioned to the left, to the right, or in the center. If the image is positioned to the left or right, the text will flow around the image.
- Border: If selected, a one-pixel border is shown on the info page image.
Info Page » General » Contact
- Email label: The label that will appear on the contact line on the info page.
- Email address: The email address that will appear on the contact line on the info page.
Info Page » Text
Info Page » Text » Title
- Title: The title that will appear on the info page.
Info Page » Text » Body
- Body: The text that will appear in the main box on the info page.
- Text alignment: The text in the main box on the info page can be centered, left-aligned, right-aligned, or justified.
- Do not insert HTML breaks: Normally, the skin converts linefeeds in the text you enter to HTML <br> tags. If this option is chosen, the skin will not do this conversion. This is useful if the text you are providing already contains HTML paragraph or break tags, and insertion of additional break tags would disrupt that HTML code.
Code » CSS
- CSS: CSS code entered here will be inserted at the end of the output common.css file when the album is created. jAlbum variables will be replaced with their actual values. This can be used to override the album's own CSS attributes, or to add attributes to support additional page material, like the menu system on the Mars Sample Albums page.
Code » Top Info
Code » Bottom Info
- Copyright notice: A copyright notice may be placed at the bottom of album pages. There are various ways to produce a copyright symbol. On a Windows machine, hold down the ALT key, type the numerals 0169 on the number pad (you can't use the numbers on the top row of the keyboard), then release the ALT key. On a Mac, hold down the Option key, type g, then release the Option key. On any platform, you can use the HTML entity for a copyright symbol: ©
- Top level only: If selected, the copyright notice will appear only on the top-level index page.
- Meta "description" tag: The entered text will be inserted into every page as a meta description tag. This is used by most search engines to describe a site when it is listed in search results. Therefore, the text should be a simple description of the site contents. If no text is entered, the skin assembles a description for each page from the folder title and comment or the image title and comment.
- Meta "robots" tag: The chosen tag will be inserted into every page. A meta robots tag may be used to tell search engine robots whether to index this page and whether to follow links on this page.
- Favicon location: Provide the absolute address of the favicon file for the website. Normally, the favicon file would be stored at the root of your domain, for example, http://example.com/favicon.ico. The file should never be added to the jAlbum project itself, and should be uploaded to your web host independently of the album. Note that if you host your album at jalbum.net, a favicon with the default name, i.e., https://yourname.jalbum.net/favicon.ico, will be overridden by the default jAlbum favicon (Dor). To use your own favicon with jalbum.net hosting, it must be given a different name, like mydog.ico. Favicon files may be ICO, PNG, or GIF files, must be square, and must have dimensions of 16x16, 32x32, 48x48, or 64x64.
- Google Analytics code: Copy and paste the entire code snippet provided to you by Google Analytics. It will be inserted at the appropriate location in every page.
- HTML language: Select the language code that corresponds to the predominant language used in your album. This will be used in the <html> tag on every page of the album. It's helpful for search engines, for browser translations, and in some cases for choosing correct typography. It defaults to the language you have chosen for jAlbum. If the language code you want to use is not in the list, you may enter any of the standard codes manually.
Custom » Create a custom style
- Create a custom style based on an existing style: The user can select one of the preset Mars styles as the starting point for creating a custom style. This resets the color settings to those of the preset style selected.
Custom » Index Pages
- Body: The color of the body of the pages.
- Borders: The color of the image borders.
- Text: The color of text on the pages.
- Top of page icon: The color of the "top of page" icon.
- Top of page background: The color of the "top of page" icon background.
- Folder icon background: The color of the background of the folder icon, if no representing thumbnail is selected.
Custom » Slides
- Background: The color of the slide image background, including the caption area.
- Text: The color of text on the slides.
- Lightbox: The color of the lightbox dimming layer behind the slides.
- Lightbox border: The color of the border around the lightbox image and caption area. If off-image slide navigation arrows are chosen, this color is also used for the arrows.
Custom » Info Page
- Page title: The color of the info page title.
- Box background: The color of the text box on the info page.
- Text: The color of text on the info page.
- Text link hover: The color of link text on the info page, when hovered on.
Custom » Theme Image
- Text: The color of the page title and description shown on the theme image.
- Background tint: The color of the dimming layer that appears behind the title and description.
- Background opacity: The opacity of the dimming layer that appears behind the title and description.
Custom » Banner
- Background color: The color of a banner title bar.
- Text: The color of the page title and description shown on a banner.
Custom » Body Background Texture
- Add / Remove: Click Add to select a background image for the page body. Click Remove to remove the image. This should be a small texture pattern that is then repeated over the page body.
- File: This field displays the name of the chosen file, but cannot be directly edited. To change a background image, remove the existing one and add a new one.
- Mars: The version number currently installed.
- Mars Release Notes: A link to the release notes.
- Mars User's Manual: A link to this user's manual.
- Mars Home Page: A link to the Mars demonstration page.
- Mars Support Forum: A link to the jAlbum forum section for Mars support.
- Mars License: A link to the Mars licensing terms.
- jAlbum Skin Page: A link to the jAlbum website page for this skin.
To access folder settings, hover on a thumbnail in the main jAlbum editing window, and click More.
Then choose Edit.
Then choose the Mars panel on the right side of the editing window.
- Folder Info Text: Clicking this button brings up a window in which you can enter top and/or bottom info text for the current folder (material to be shown above or below the thumbnail table), overriding the material provided in the main skin settings.
Info: Video Support
In Mars, support for videos added to a project is dependent upon the video support built into jAlbum. For videos to work properly in an album, video support must be enabled in jAlbum under Tools (jAlbum in macOS), Preferences, Advanced.
If the processed video dimensions are larger than the image bounds chosen under Album » Settings » Images » Image bounds » Images, the display will be reduced to fit within those bounds and within the browser window, whichever is smaller. If you choose Link to originals for the project, or Use original for one video, the video will be shown in its native size, reduced as necessary to fit within the browser window. The actual video file in the album will not be adjusted - only the display window is scaled down as necessary.
With video support enabled in jAlbum, the core program automatically provides a thumbnail image for the video. In image editing mode, a slider is available to choose a video frame other than the one automatically selected. This can be especially helpful if the video starts with several seconds of a black screen - the automatically-selected frame might be black in that case.
It is possible to provide your own representing image for the video, which could be an image that doesn't even appear in the video. Choose a full-sized image (a regular JPG file, and not just a small thumbnail), change its extension to .thm, and give it the same name as your video. For example, for a video called mydog.mp4, the image file should be named mydog.thm. This file should then be added to the project at the same time the video is added to the project. This image will then be used both for the thumbnail and for the video frame while the video is loading and after it has finished playing.
Your web host must provide video files with the correct header information. The MIME type must be video/mp4 - if an MP4 file is delivered by your web host with any other MIME type, playback will fail in some browsers. If you find that a video in your album plays properly when you preview the album locally, but displays only an error message when viewed from your web host, an incorrect MIME type is the most likely cause. Ideally, your web host should correct the server configuration, but if you can change your own .htaccess file on the server, adding this line will correct the problem:
AddType video/mp4 .mp4
In addition, video files must not be compressed by the server using something like gzip, for example.
Info: HTML Tags and jAlbum Variables
HTML tags and jAlbum variables may be used in a number of different contexts, and will be honored in the album (including things like links). jAlbum variables will be passed to the jAlbum engine and will be evaluated before they are placed in the completed album. Almost all user entries are treated in this manner:
- Album title and description
- Folder title and comment
- Image title and comment
- Custom CSS
- Top info and bottom info
- Meta description
If you use a < or > character in a text string, it is assumed to be part of an HTML tag, and may produce errors if it isn't. If you want to use one of those characters as simple text, use its HTML entity code, instead.
- for <, use <
- for >, use >
Info: Google Fonts & WOFF Files
A longstanding problem with web pages is that fonts are not actually included in the page code. The page simply includes some text, along with an instruction in the CSS that tells the browser what font to use to display that text. But if the visitor's computer doesn't have that font installed, it falls back to a default, or works its way down whatever font stack is indicated in the CSS until it finds a font that it can use. The effect of this limitation is that web page designers are generally forced to rely on a small set of "web safe" fonts, fonts that can reliably be found on most visitors' computers.
Packaging fonts with web pages in a way that allows the site visitor to install the font on his computer, while possible, runs afoul of copyright protections. Most fonts, even those normally distributed with a new computer, are protected by copyright, and you don't have the right to make them available to others.
To address this problem, Google Fonts and Web Open Font Format (WOFF) files can be used. The font is not actually installed on the visitor's computer. It is used only for displaying text on your web page.
In Mars, you may add two Google Fonts and a WOFF file, and tell the skin which font to use for each text element, with the default being the selected regular font family. Decorative fonts can be difficult to read at smaller sizes, and are therefore best used only for page titles. You are likely to find that they look better when displayed with a larger font size than you would use for a regular font, and with normal weight, rather than bold. More traditional fonts may be suitable for all text.
To choose a Google Font, visit the Google Fonts page, and identify the font you want to use. Scroll down on the page to view suggested font pairings. You might want to use a more elaborate font for titles, and a simpler font for captions. Make a note of its name, and enter the name in the Mars settings. Mars does not support the use of Google Font multiple styles. If you see a font listed, and it indicates that there are multiple styles of that font available, when you enter its name in the Mars settings, the skin will use the basic style of that font.
There are now many hundreds of free WOFF files available. Search the web for free woff to find sources (some sites require registration). In most cases, the fonts are free for you to use on your website, even if the website is commercial, but the font designers retain copyright, so you don't have permission to redistribute the files directly to others. Often, these free fonts are provided in a variety of formats - WOFF, OTF, TTF, EOT, SVG, and so on. The format needed for Mars is indicated by a .woff file extension. In many cases, the download will be provided as a zip archive containing several formats - you need to extract the .woff file from that archive and use that one for inclusion in the skin.
The FontSquirrel site is a typical example, offering many free fonts. Find one you like, and then click on the name of the font (not on the Download link). Then look for a Webfont Kit link on the menu bar. There, you can choose the WOFF format. If a font is available in only one format, the Webfont Kit menu bar choice will be absent. In that case, you can download another format, like TTF, then use FontSquirrel's Webfont Generator to upload the TTF and convert it to WOFF - choose the Expert radio button after you've uploaded the TTF version. In short, it may take some exploration to find the WOFF file you need.
See Fonts » Album to include a Google Font and/or WOFF file in your album.
Info: Linking to Originals
If you choose Link to originals in the main jAlbum settings (Album » Settings » Pages), your images will not be scaled or modified in any way. They will be used directly in the slide pages of the album. the skin will adjust the slide display to the visitor's viewport, but because the files have not been scaled, the file sizes may be very large, making this setting a poor choice for a web album. However, you can resize your images before using them in jAlbum, in which case choosing Link to originals might be suitable. If you also select HiDPI images, your original images will be shown at one-half their native dimensions, to preserve clarity on high-density displays.
If you choose Link to scaled-down images only, videos will be shown in their native dimensions, or to fit within the image bounds, or to fit within the visitor's viewport, whichever is smaller. If you choose Link to originals, videos will be shown in their native dimensions, or to fit within the visitor's viewport, whichever is smaller.
Info: Master Album
With almost any skin, it's possible to create folders and subfolders, and produce a multilevel album. But in most cases, all levels must use the same skin, and usually the same style of that skin, as well. Mars, however, can be used to create a master index of other albums; each album may use a different style of the Mars skin, or a different skin entirely.
- Create each of the other albums, and upload them to your web host. They can be arranged in a uniform hierarchical directory structure (for example, with each individual album residing in a subdirectory under the location of the master index), or can be placed in any location on the web host, or even on other web hosts.
- Create a project for the master index, and add a web location for each sub-album. You can drag a URL from the address bar of your browser (or the circled "i" or padlock symbol to the left of the address) into the jAlbum Explore window in your project, or you can right-click in the jAlbum Explore window and choose New page, Web location, and enter the full URL of the sub-album. jAlbum will then try to extract an image from that website, but if you want to use another image, you can click the folder icon to the right of the Image URL field, and navigate to an image you want to use instead.
- Ideally, each sub-album should provide a means by which the site visitor can return to the master index. Most skins provide a way of entering an uplink from the main level. If you have chosen a hierarchical directory structure for your individual albums, the uplink would be ../index.html; otherwise, an absolute URL is required, such as http://example.com/master/index.html.
- Using the same technique, i.e., adding web locations to a project, you can create an album in which each thumbnail leads to another web site. The other sites don't have to be created with jAlbum - you can add thumbnails that take the visitor to any other web sites.
Info: Version Updating
New versions of Mars are published with some regularity. These new versions generally include new features, improvements, and bug fixes. The jAlbum application will let you know when a new version is available, and users are encouraged to download and install the new version.
- It is best to install a new version of the skin with the jAlbum application closed, i.e., not running. Save the Mars.jaskin file to your computer, close jAlbum, launch the Mars.jaskin file to do the installation, then launch jAlbum again.
- If you have a project that was created with an older version of Mars and you're happy with it, and don't intend to add any images to it or make any other changes to it, there's no reason to make the album again with the latest version of the skin. However, if you intend to change that project in any way, it should be reprocessed with the newest version.
- Before re-making an existing album with a new version of the skin, read the release notes, and create a small test album to see the effect of newly-introduced features. These new features are sometimes enabled by default in a new version, and will be applied to your existing project unless you choose to turn them off. The time to discover this is not after you've rebuilt an entire 10,000-image album.
- There is no need to invoke Force Remake in jAlbum. This forces jAlbum to reprocess all of the images, rather than just generating new HTML and CSS files. This is almost never required. Just click Make Album, and let jAlbum decide what needs to be updated.
- However, if your project contains folders (subdirectories), it is very important that all subdirectories be processed with the new version of the skin. All of the pages in an album share the same CSS files, and having a page of HTML generated with an older version of the skin using a CSS file created with the newest version could produce catastrophically bad results. Under Album » Settings » Advanced » General, be sure to check Process subdirectories and Include subdirectories in index pages. Be sure not to check Process only updated subdirectories. An updated subdirectory is one that has had images added to it, or removed from it. Other settings changes, or the use of a new version of the skin, does not cause jAlbum to regard subdirectories as being "updated."
- For an active project, one that you make changes to periodically, it is recommended that you stay abreast of new skin versions. Generally, the process of updating an album by one or two skin versions is easy, and takes very little time. Trying to jump over many versions, however, could require considerable effort. Stay current to avoid problems.
- After you have opened an existing project with the new skin version, it's a good idea to save the project, even if jAlbum doesn't prompt you to do so. This saves newly-defined skin variables with the project, which makes subsequent project opening smoother and less prone to errors.
Info: Browser Support
Mars produces albums that display properly in most browsers.
- Standards compliance: Mars produces valid HTML5 and CSS3 code. However, no attempt is made to ensure that user-provided code (in titles, comments, etc.) is valid.
- Current desktop browsers: All Mars skin features are supported in the current versions of Chrome, Firefox, and Safari. The parallax effect is visible in Edge, but the scrolling is very jerky. Edge is known to have problems achieving smooth scrolling - it's not just the parallax effect that suffers. In Edge prior to version 79, the tinted background behind the album title and description is not visible.
- Other browsers: Mars is not tested in any other browsers. Support for skin features is unknown.
- Tablet browsers: Mars is only occasionally tested on any tablets (e.g., iPad), but all skin features should operate properly. Simple swipe gestures are supported.
- Smartphones: Mars is tested in Chrome and Firefox on an Android phone, and is occasionally tested in Chrome and Safari on an iPhone. All skin features should operate properly. Simple swipe gestures are supported.
- jAlbum integrated browser: The integrated browser in jAlbum does not support the parallax effect, and the theme image is distorted. It also makes a mess of the thumbnail table in some cases. You should preview your album in a real browser (Chrome, Firefox, or Safari) before concluding that there's a problem with it.
- jAlbum embedded web server: If you choose to preview your albums with Chrome, and you use the jAlbum embedded web server (see Tools/jAlbum (Windows/Mac), Preferences, General, Preview), you may see some image flickering when moving from slide to slide. This will not occur when viewing the album from a server.
The Mars skin for jAlbum, including all supporting files, source code, compiled code, and scripts, ©2021, Jeff Tucker.
The skin uses the following open-source scripts:
You may use the software to create albums for personal or commercial sites. You may distribute copies of the software to others, but for any reuse or distribution, you must make clear to others the license terms of this software. You may modify the software for your own use.
The copyright holder reserves the right to waive or to withdraw any of these terms on a case-by-case basis.
The jAlbum application is free for personal use during the initial trial period, but after that, a Standard license is required. For commercial use, a Pro license is required. Visit the jAlbum site for further information.