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.

L'édition java -jar JAlbum.jar -help est installée dans le même dossier que l'application jAlbum et jAlbum listera tous paramètres autorisés. 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
-accountProfileName 
-albumAddress 
-albumHeight 420
-albumWidth 560
-baseDirectory 
-chainDirectories false
-characterEncoding 
-classicReaders false
-closeupDirectory slides
-closeupPrefix 
-cols 6
-connected false
-copyOriginals true
-cpuCores 4
-creator 
-creditText credit8
-customImageOrdering 
-dateFormat 
-directoriesFirst true
-directory 
-displayVersion 15.1 (Currently installed version)
-excludeBacklinks false
-excludeByDefault false
-exifImageDescription false
-exifUserComment false
-fileNamer 
-forceJPEGWriting false
-ftpForceUTF8 false
-ftpPassword 
-ftpPort 21
-ftpServer 
-ftpUser 
-hiDPIImages false
-hiDPIThumbs false
-highQualityThumbs true
-highThumbnailCompressionQuality false
-hiResDirectory hi-res
-homepageAddress 
-homepageLinkText 
-ignorePattern \..*
-imageBackgroundColor #ffffff
-imageLinking LinkScaled
-imageOrdering OrderByDate
-imageSize 640x480
-includeDirectories true
-includeHiResImages true
-includePattern 
-indexPageName index
-internalVersion 15.1b1
-iptcCaption true
-jpegComment false
-keepMetaData false
-keepXmpData true
-makeThumbs true
-mediaRSS true
-metaData true
-myjalbum false
-outputDirectory album
-overrideExistingCopyright false
-pageExtension .html
-pageNamer 
-passiveMode true
-programDirectory /Applications/jAlbum.app/Contents/Java or for Windows C:\Dev\Java\jAlbum
-progressiveMode false
-projectFile 
-protocol ftp
-qualityPercent 85
-readXmp true
-remoteDirectory album
-remoteFS info.cqs.remotefs.RemoteFSBean@15975490
-resourceDirectory res
-reverseOrder false
-rights 
-rightsURL 
-rows 4
-runTool 
-scalingMethod ScaleSmooth
-searchEngineFriendlyNames false
-sharpenPercent 25
-skin Tiger
-skinsDirectory /Applications/jAlbum.app/Contents/Java/skins or for Windows  C:\Dev\Java\jAlbum\skins
-slideDirectory slides
-slides true
-smartUpload 
-smoothScalingType STANDARD
-style Linen.css
-subdirs true
-superimposeFilmIcon true
-suppressIEWarnings true
-textEncoding UTF-8
-textFileComment true
-themeImageProcessor 
-thumbnailDirectory thumbs
-thumbnailPrefix 
-thumbSize 124x124
-titleSource IPTCObjectName
-updatedDirsOnly false
-uploadAll 
-urlEncode true
-useCustomVideoSettings false
-user.<your variable> <value>
-useThumbForFolderIcon true
-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=
-videoQuality 50
-videoResolution p480
-visibleOnProfilePage true
-webPassword 
-webSafeNames true
-widgetInjection true
-writeUTF8 true

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

-appendImages n'est plus inclus dans la liste des commandes -help, il est affiché pour les anciennes versions de jAlbum. C'est l'équivalent d'utiliser créer ‘Modifications’, il ne traite pas les images et remplace le défaut de jAlbum de faire un ‘smart make’ (ou Créer tout si jAlbum est plus vieux que 8.1 !), en mettant à jour seulement les fichiers qui ont besoin d'être retraités. Utilisez avec soin !

-includeHiResImages est l'équivalent de ‘Lien vers haute résolution* via les images réduites’ qui n'est disponible que pour les versions de jAlbum antérieures à 15.


Les variables définies par l'utilisateur sont transmises -user.votreVariable "Value". Applications semblables aux variables définies du skin (ayant un préfixe -skin.). Le mode ligne de commande est idéal pour l'automatisation de la production et des mises à jour de l'album. Les webmasters peuvent faire des scripts qui appellent l'application jAlbum régulièrement 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

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 -appendImages

(The -Xmx400M flag allows jAlbum to grab up to 400MB of RAM if needed. The default of 64MB is not enough)

Voici un autre exemple qui télécharge le même projet à un serveur web (v6):

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 ordinaire (sans accès au système de fenêtrage X) ajouter le commutateur de ligne de commande -Djava.awt.headless=true.