Bannière du site

Guide utilisateur jAlbum

fleche_haut

jAlbum / Fonctionnement jAlbum depuis la ligne de commande

L'application jAlbum peut également être contrôlée à partir de la ligne de commande. Elle accepte les mêmes paramètres que vous êtes en mesure de régler par le biais de l'interface utilisateur graphique.

Si vous rencontrez des problèmes lors de l’exécution de jAlbum à partir de la ligne de commande Windows, assurez-vous que la commande commence par le chemin d’accès au Java fourni par jAlbum. Par exemple, si vous êtes dans le répertoire du programme jAlbum, vous pouvez entrer ce qui suit sur la ligne de commande pour obtenir une liste de tous les paramètres autorisés :

jre64\bin\java -jar JAlbum.jar -?

Peu importe où vous vous trouvez dans la structure de répertoires, vous pouvez entrer ce qui suit sur la ligne de commande pour obtenir une liste des paramètres :

"C:\Program Files\jAlbum\jre64\bin\java" -jar "C:\Program Files\jAlbum\JAlbum.jar" -?

Les utilisateurs d’OS X doivent utiliser Terminal et entrer :

/Applications/jAlbum.app/Contents/MacOS/jAlbum -help

Sélectionnez Outils->Ouvrir un dossier->"Dossier du programme" pour trouver le bon dossier.

Voici une liste des paramètres actuellement autorisés et leurs valeurs par défaut :

 
-acceleratedScaling true (Settings » Images » Advanced » Attempt to use hardware accelerated scaling)
-accountProfileName (Upload » Account » profile name)
-albumAddress (Upload » Location : Settings » General » Address)
-albumHeight 420 (Share » Embed album » Album height)
-albumWidth 560 (Share » Embed album » Album width)
-appendImages (Make Test)
-baseDirectory 
-classicReaders false (Used by old Java versions of jAlbum)
-closeupDirectory slides (Settings » Advanced » Naming » Close up directory)
-closeupPrefix (Settings » Advanced » Naming » Close up prefix)
-cols 6 (Settings » Pages » Thumbnail layout » Columns)
-connected false 
-copyOriginals true (Settings » Pages » Image linking » Copy originals if needed)
-cpuCores 4 (Preferences » General » No of threads)
-creator (Settings » Images » General » Copyright embedding » Creator)
-creditText credit1 (Settings » Pages » Credit links » Text)
-currentProject 
-customImageOrdering 
-dateFormat (Settings » Advanced » General » Date format)
-DdebugVariants=true (combined with forceProcessing=true will print variant size on to images)
-directoriesFirst true (Settings » Pages » Image ordering » directories first)
-directory (Settings » General » Image directory)
-directoryChaining NO_CHAINING (Settings » Advanced » General » Chain directories)
-disableColorSubsampling false (Settings » Images » Advanced » Disable color sampling)
-displayVersion 24 (No setting, generated value)
-excludeBacklinks false (Settings » Pages » Credit links » Exclude credit links)
-excludeByDefault false (Settings » Advanced » General » Exclude new images by default)
-exifImageDescription false (Settings » Advanced » Metadata » Comment sources » EXIF Image desc.)
-exifUserComment false (Settings » Advanced » Metadata » Comment sources » EXIF user)
-fileNamer
-folderThumbSize 400x400 (Settings » Images » Image bounds » Folders)
-forceJPEGImages false(Settings » Images » Advanced » Force JPEG images)
-forceJPEGThumbs false (Settings » Images » Advanced » Force JPEG thumbnails)
-forceProcessing false (Settings » Images » Advanced » Force processing of small images)
-ftpForceUTF8 false 
-ftpPassword (Upload/Manage step 1 » Password)
-ftpPort 21 ( (Upload/Manage step 1 » Advanced)
-ftpServer ( (Upload/Manage step 1 » Server name)
-ftpUser ( (Upload/Manage step 1 » User name)
-generateJSON false (Settings » Advanced » Metadata » Generate JSON data)
-hiDPIImages false (Settings » Images » General » HiDPI images)
-hiDPIThumbs false (Settings » Images » General » HiDPI thumbnails)
-highQualityThumbs true (Setting removed from version 18)
-homepageAddress (Settings » Pages » Link to home page » Address (URL))
-homepageLinkText (Settings » Pages » Link to home page » Text)
-ignorePattern \..* (Settings » Advanced » General » Ignore pattern)
-imageBackgroundColor #ffffff (Settings » Images » Advanced » Background color for translucent images)
-imageLinking LinkScaled (Settings » Pages » Image linking from thumbnails » Link to…)
-imageOrdering OrderByDate (Settings » Pages » Image Ordering » )
-imageSize 640x480 (Settings » Images » General » Image bounds » Images)
-imageVariants [] (Settings » Images » Variants » Images)
-includeDirectories true (Settings » Advanced » General » Include subdirectories in index pages)
-includePattern (No setting - symmetry for ignore pattern?)
-indexPageName index (Settings » Advanced » Naming » Index page name)
-internalVersion current version xx.xx.xx (No setting, generated value)
-iptcCaption true (Settings » Advanced » Metadata » Comment sources » IPTC caption)
-jAlbumVersion 28.1.6 (current version xx.xx)
-jpegComment false (Settings » Advanced » Metadata » Comment sources » JPEG)
-keepMetaData false (Settings » Advanced » Metadata » Include photographic data in generated images)
-keepXmpData true (Settings » Advanced » Metadata » Include XMP metadata in generated images)
-makeThumbs true (Set by the skin)
-mediaRSS true (Settings » Advanced » Metadata » Generate media RSS feed)
-metaData true (Settings » Advanced » Metadata » Include photographic data in generated pages)
-myjalbum false (??)
-notes (Settings » Advanced » Notes » Text field)
-notifyNotes true (Settings » Advanced » Notes » Notify on project load)
-outputDirectory album (Settings » General » Output directory)
-outputFormat JPEG (Settings » Images » Advanced » Output format)
-overrideExistingCopyright false (Settings » Images » General » Copyright embedding » Override existing)
-pageExtension .html (Settings » Advanced » Naming » Page extension)
-pageNamer (Settings » Advanced » Naming » Index page name)
-passiveMode true (Upload/Manage step 1 » Advanced » Passive mode)
-processFolderThumbs false (Settings » Images » General » Image bounds » Process folder thumbnails)
-programDirectory /Applications/jAlbum.app/Contents/app (Location of jAlbum application on the OS file system)
-projectFile (path to the project settings file)
-protocol ftp (Upload step 1 » Current Account » Type)
-qualityPercent 85 (Settings » Images » General » JPEG quality)
-qualityPercentWebP 60 (Settings » Images » General » WEBP quality)
-readXmp true (Settings » Advanced » Metadata » Comment sources » XMP)
-remoteDirectory VALUE_UNSET (Upload » Selected location)
-resourceDirectory res (No setting)
-reverseOrder false (Settings » Pages » Image ordering » Reverse)
-rights (Settings » Images » General » Copyright embedding » Copyright)
-rightsURL (Settings » Images » General » Copyright embedding » Copyright URL)
-rows 4 (Settings » Pages » Thumbnail layout » rows)
-runTool (Path to an external tool to be run)
-scalingMethod ScaleSmooth (Settings » Images » General » Scaling method » Smooth)
-searchEngineFriendlyNames false (for backward compatibility)
-sharpenPercent 25 (Settings » Images » General » Sharpen)
-skin Tiger (Name of skin to use)
-skinsDirectory /Applications/jAlbum.app/Contents/app/skins
-slideDirectory slides (Settings » Advanced » Naming » Slide directory)
-slides true (Settings » Pages » Image linking from thumbnails » Make slide pages)
-smartUpload (Make album)
-smoothScalingType STANDARD (Settings » Images » General » Scaling method » Custom)
-style Linen.css (Skin and Style » Style)
-subdirs true (Settings » Advanced » General » Process subdirectories)
-superimposeFilmIcon true (Settings » Images » Advanced » Superimpose play icon on video thumbnails)
-textEncoding UTF-8 (Settings » Advanced » General » Encoding)
-textFileComment true (Settings » Advanced » Metadata » Comment sources » Jalbum (text file))
-themeImageProcessor (??Skin??)
-themeImageSize (Set by the skin)
-thumbnailDirectory thumbs (Settings » Advanced » Naming » Thumbnail directory)
-thumbnailPrefix (Settings » Advanced » Naming » Thumbnail prefix)
-thumbSize 124x124 (Settings » Images » Image bounds » Thumbnails)
-thumbVariants [] (Settings » Images » Variants » Thumbnails)
-titleSource IPTCObjectName (Settings » Advanced » Metadata » Title source)
-updatedDirsOnly false (Settings » Advanced » General » Process only updated subdirectories)
-uploadAll (Upload step 2 » Upload » Upload all)
-urlEncode true (backward compatibility)
-useCustomVideoSettings false (Settings » Videos » Use custom settings)
-user.<your variable> <value>
-useThumbForFolderIcon true (Settings » Advanced » General » Use thumbnail for folder icon)
-videoParameters -y=,-i=$inputPath,-vf=hqdn3d\=1.5:1.5:6:6\,scale\=min(iw\\\,trunc(iw*min($videoWidth/iw\\\,$videoHeight/ih)*0.5)*2):min(ih\\\,trunc(ih*min($videoWidth/iw\\\,$videoHeight/ih)*0.5)*2)\,unsharp\=3:3:1.0:3:3:0.0\,$normalizeOrientation,-ss=$clipStart,-t=$clipLength,-threads=0,-b:a=96k,-ac=2,-ar=44100,-vcodec=libx264,-crf=$videoQuality,-metadata:s:v:0=rotate\=0,-movflags=faststart,-pix_fmt=yuv420p,$outputPath= (Settings » Videos » Advanced)
-videoQuality 50 (Settings » Videos » Quality)
-videoResolution p720 (Settings » Videos » Resolution)
-visibleOnProfilePage true (Upload » Privacy » Visible on profile page)
-webPassword (Upload » Privacy » Password)
-webSafeNames true (backward compatibility)
-widgetInjection true (Settings » Advanced » Metadata » Include jAlbum widget support)
-writeUTF8 true (Settings » Advanced » General » Write UTF-8)

Les arguments obligatoires sont -directory et (-outputDirectory ou -sameDirectory).

Vous pouvez faire correspondre les paramètres ci-dessus à leurs paramètres d’interface graphique en les référençant dans GUI Settings and album-settings.jap

Les variables définies par l’utilisateur sont transmises sous la forme -user.yourVariable "Value". Il en va de même pour les variables définies par l’enveloppe (ayant un préfixe -skin. Le mode de ligne de commande est idéal pour la génération et les mises à jour automatisées d’albums. Les webmasters peuvent créer des scripts qui appellent régulièrement l’application jAlbum pour mettre à jour les albums du serveur, etc.

Les variables et leurs paramètres sont sensibles à la casse, alors pensez à écrire -projectFile, pas -projectfile ou -ProjectFile par exemple.


Passer des paramètres est accompli en utilisant le commutateur -D avant le paramètre -jar, par exemple

java -Duser.language=en -jar JAlbum.jar

Vous pouvez voir quels paramètres peuvent être utilisés en consultant la liste des propriétés dans le help/about menu (en anglais)

Exemples

Remarque, dans les exemples suivants, les commandes sont affichées sur des lignes séparées pour plus de clarté et de lisibilité sur des écrans plus petits, les commandes doivent en fait être entrées comme une seule ligne de commande.


Voici un exemple qui met à jour un album de fichiers dans D:\Nature et attrape les autres paramètres du fichier de projet nature.jap :

java -Xmx400M -jar JAlbum.jar 
-directory D:\Nature 
-sameDirectory 
-projectFile nature.jap 

Sur un Mac, ce serait quelque chose comme ça (sur une ligne)

/Applications/jAlbum.app/Contents/MacOS/jAlbum 
-directory /Users/userName/My\ Albums/ProjectName 
-sameDirectory jalbum-settings.jap

Voici un autre exemple qui téléverse le même projet à un serveur web (v6). Remarque pour "créer et télécharger" l’album, vous devez d’abord le "créer", comme dans l’exemple ci-dessus, puis exécutez à nouveau la commande avec -smartUpload ajouté :

java -jar JAlbum.jar 
-directory D:\Nature 
-sameDirectory 
-projectFile nature.jap 
-smartUpload


Voici un exemple qui fait entrer jAlbum en "mode serveur" en exécutant l'Outil "Server mode". En "mode serveur", jAlbum surveille les changements dans le dossier d'image. Dès qu'un changement est détecté (nouvelle image ajoutée, par exemple) une opération "Créer l'album" est déclenchée. jAlbum reprend alors la surveillance du dossier d'images.

java -Xmx400M -jar JAlbum.jar 
-projectFile nature.jap
-runTool "tools/Server mode.bsh"


Voilà enfin comment lancer jAlbum en mode fenêtré à partir d'une ligne de commande et de le faire charger un projet d'album :

java -Xmx400M -jar JAlbum.jar 
jalbum-settings.jap"

Utilisateurs Linux/UNIX : Pour exécuter jAlbum depuis la ligne de commande dans un système de serveur simple (sans accès au système de fenêtrage X) ajouter le commutateur de ligne de commande -Djava.awt.headless=true.