Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LLGAL(1)		    General Commands Manual		      LLGAL(1)

NAME
       llgal - On-line gallery generator

SYNOPSIS
       llgal [-option1 -option2	...]

DESCRIPTION
       llgal  is  a  quick and easy program for	placing	your images and	movies
       online with just	one command-line. It generates a  pretty  good-looking
       set  of	static	HTML slides even with its default settings.  To	try it
       out just	run llgal in a directory with jpg, png,	 mpg,  etc  files  and
       check  the  output  in a	web browser.  You can adjust the appearance of
       the image gallery with the many options listed below or (if you know  a
       bit  of HTML) by	modifying the llgal.css	files in the .llgal/ subdirec-
       tory that appeared in your image	directory, or  by  defining  indextem-
       plate.html or slidetemplate.html	files.

       llgal  also checks for the existence of a $HOME/.llgal/ directory where
       users  can  store  their	 own  templates,  overriding   the   site-wide
       /usr/share/llgal.  (See FILES for details).

       The HTML	webpages are generated from the	templates by replacing several
       fields (See TEMPLATES).	The layout might  be  configured  through  the
       list of options that are	given in LAYOUT.

       llgal  uses  all	 images	 and videos it finds in	the current directory.
       See SELECTING FILES to include directories or other files and  excludes
       some filenames.

       The  index  includes  thumbnails	that llgal generates from original im-
       ages.  It is possible to	provide	custom thumbnails by placing  them  in
       the  .llgal/ directory with the mythumb_	prefix.	 Custom	thumbnails for
       movies have to be suffixed with an image-type extension.	 For instance,
       to  enforce  the	 thumbnail  for	 image	image.jpg and movie movie.avi,
       thumbnails may be named mythumb_image.jpg and mythumb_movie.avi.jpg.

       The slide pages may include a scaled image in the --sx or  --sy	option
       is  passed.  Similarly, it is also possible to define custom scaled im-
       ages with the myscaled_ prefix to appear	in the slides.

       Note that all command line options  (except  those  from	 BEHAVIOR  OP-
       TIONS),	and even more, might be	stored in a configuration file to help
       generation of multiple galleries	with the same layout.  See  CONFIGURA-
       TION for	details.

BEHAVIOR OPTIONS
       By  default, llgal generates a gallery.	If one of the following	option
       is passed, it will process it and exit immediately.

       --clean
	      Remove all files that llgal may have created  earlier  and  that
	      user did not modify since.

       --cleanall
	      Remove  all  files that llgal may	have created earlier. This in-
	      cludes thumbnails, scaled	down slides, all HTML files,  captions
	      file,  film  effect picture, indextemplate and slidetemplate and
	      the style-sheet file.

       --gc   Generate slide captions in .llgal/captions  file	that  you  may
	      edit.  The format	of this	file is	very simple.  See CAPTIONS for
	      details.	These captions may then	be modified by the user.   The
	      file  will  be  automatically  used  next	time llgal is invoked.
	      --gc might also be used to update	the  captions  file  when  new
	      files were added to the working directory.

       --gt [_dir_]
	      Copy  template  files to the directory.  The special value local
	      might be used for	the local .llgal/ directory, while user	 might
	      be  used	for  the  user	template directory $HOME/.llgal/.  Any
	      other directory is acceptable.  llgal will create	the target di-
	      rectory  if  it  does not	exist.	The argument is	optional.  Its
	      default value is local.  See FILES for  details  about  template
	      files.

       -h, --help
	      Display brief help.

       -V, --version
	      Display llgal version.

ADDITIONAL BEHAVIOR OPTIONS
       llgal  behavior may be modified with the	following options, either when
       generating a gallery or not.

       --config	_file_
	      Read the file file as a configuration.   See  CONFIGURATION  for
	      details.	 Note  that  --config may be used several times	on the
	      same command line.  The corresponding configuration file	option
	      is additional_configuration_file.

       -d _dir_
	      Operate  in  directory  _dir_  when  generating  the HTML	files,
	      thumbnails and scaled images.  The default is the	current	direc-
	      tory.

       -f     Force thumbnail regeneration.  Also forces medium-slide regener-
	      ation if --sx or --sy is given.  Otherwise llgal will not	regen-
	      erate these files	if they	already	exist, and you may end up with
	      stale copies.  Definitely	use -f between two runs	 where	you've
	      changed  the value of --tx, --ty,	--sx or	--sy.  The correspond-
	      ing configuration	file option is force_image_regeneration.

       --gencfg	_file_
	      Output configuration in file for	future	reutilization  through
	      --config.	 If local is passed as file, then the local .llgal/ll-
	      galrc file is created in each gallery that is processed (in case
	      of recursion).  See CONFIGURATION	for details.

       --option	'variable = value'
	      Configure	 using a configuration file option.  See CONFIGURATION
	      for details.  Note that --option may be used  several  times  on
	      the same command line.

       -R     Enable recursive mode.  llgal will be run	inside subdirectories.
	      This option might	be used	either to generate  galleries  in  all
	      subdirectories,  or  their  captions  files,  or to clean	recur-
	      sively, etc.  The	corresponding configuration file option	is re-
	      cursive.

	      When generating a	gallery, this option implies -S	that means ll-
	      gal will use all existing	subdirectories in no captions file  is
	      defined.	 If  a captions	file is	defined, only the DIR: entries
	      will be entered recursively.  See	CAPTIONS for details abour

	      Note that	recursive behavior does	only use the contents  of  the
	      captions	file to	choose which subgalleries to enter when	gener-
	      ating the	gallery	or the captions	file.	All  other  behaviors,
	      including	 recursive cleaning ( -R used together with --clean or
	      --cleanall), will	not check whether a  subdirectory  is  in  the
	      captions	file.	All  not-dot-beginning	subdirectories will be
	      cleaned.

       -v, --verbose
	      Display notice messages.	The corresponding  configuration  file
	      option is	verbose.

SELECTING FILES
       -A     All  files  in  the  current directory will get a	slides,	except
	      .html or dot-beginning files.  Files are matched	as  images  or
	      movies  first,  and  then	reverted as simple files instead.  The
	      corresponding configuration file option is  add_all_files.   See
	      -S for details about adding slides for subdirectories.

       --exclude _s_
	      Exclude files whose name matches _s_.  The corresponding config-
	      uration file option is exclude.

       --include _s_
	      Include files whose name matches _s_ and	where  previously  ex-
	      cluded.  The corresponding configuration file option is include.

       -P _subdir_
	      Use photos in the	subdirectory instead of	the working directory.
	      May be used multiple times to group multiple  subdirectories  in
	      the same gallery.	 The path of the subdirectory must be given as
	      a	relative path (relative	to . or	to the path given to -d).  The
	      corresponding configuration file option is section_dir.

       --Pall Use photos in all	subdirectories all the working directory as if
	      -P was used for all of them.   The  corresponding	 configuration
	      file option is recursive_sections.

       --Ps   Add  a  horizontal  line and the subdirectory name as a title at
	      the beginning of each section.  The corresponding	 configuration
	      file options are entitle_sections	and separate_sections.

       -S     Each  subdirectory  will	get  a dedicated slide.	 If a captions
	      file exists, only	the subdirectories that	 it  defines  will  be
	      processed.   If  no captions file	exists,	llgal will process all
	      subdirectories but those whose name begins with a	dot.  The cor-
	      responding configuration file option is add_subdirs.

	      Contrary	to  -R this option will	not make llgal run recursively
	      in subdirectories.  -S does only define the list of  subdirecto-
	      ries that	appear in the current gallery.

LAYOUT OPTIONS
       -a     Write image dimensions and sizes under each thumbnail on the in-
	      dex page,	and under each slide if	--sx or	--sy was passed.   The
	      corresponding configuration file options are show_dimensions and
	      show_size.  This only works if the ImageMagick command  identify
	      is present.

       --ad   Like  -a but write only the image	dimensions.  The corresponding
	      configuration file option	is show_dimensions.

       --as   Like -a but write	only the image sizes.  The corresponding  con-
	      figuration file option is	show_size.

       --asu _s_
	      Define  the unit used to show file sizes.	 Default is "kB".  The
	      corresponding configuration file option is show_size_unit.

       --cc [_s_]
	      Generates	captions from image comment tag.  If  no  argument  is
	      given, llgal first tries the standard comment (for instance JFIF
	      or GIF), then tries Exif comments	if the previous	one is	empty,
	      and  then	 tries Exif image description.	The corresponding con-
	      figuration file option is	make_caption_from_image_comment.

	      An argument such as std or exif or exifdesc might	 be  added  to
	      force  the  use  of only standard	comment, only Exif comment, or
	      only Exif	image description.

	      An argument such as exif,std will	make llgal  try	 Exif  comment
	      first.

	      An  argument  such  as  std+exifdesc will	use the	combination of
	      standard comment and Exif	description.

	      Passing --cc without argument is thus equivalent to passing --cc
	      std,exif,exifdesc.

       --cf   Generates	captions from file names (strips extension, except for
	      directories).  The corresponding configuration  file  option  is
	      make_caption_from_filename.

       --ct  [strftime_format]
	      Add  image  timestamp  tag to the	generated captions, and	change
	      its format if the	optional argument is given (replaces  the  old
	      --ctf  option).  The corresponding configuration file option are
	      make_caption_from_image_timestamp	 and  timestamp_format_in_cap-
	      tion.

       --codeset codeset
	      Change  the  encoding in the header of the generated HTML	pages.
	      By default, the encoding is got from the	locale	configuration.
	      The corresponding	configuration file option is codeset.

       --exif [_tag1,tag2,..._]
	      Display a	table of EXIF tags under each image slide.  The	corre-
	      sponding	configuration  file  options  are  show_exif_tags  and
	      show_all_exif_tags.

	      If  an  argument is given, it contains a comma-separated list of
	      tags.  The tag names have	to be  passed  as  shown  by  exiftool
	      -list.   If  no  argument	 is given, all available Exif tags are
	      displayed.

	      The tags are displayed  using  their  description	 as  given  by
	      exiftool -s myimage.

       --fe   Show  a  film  effect  in	the index of thumbnails. The aspect of
	      this effect may be configured by replacing the  tile  file  that
	      llgal  puts in .llgal.  The corresponding	configuration file op-
	      tion is show_film_effect.

       -i _file_
	      Name of the main thumbnail index file.  The default is index, as
	      desirable	for most web servers.  The corresponding configuration
	      file option is index_filename.

	      The default extension is html and	might be changed with --php or
	      the www_extension	configuration option.

       -k     Use  the	image captions for the HTML slide titles.  The default
	      behavior is to use the image names.  The corresponding  configu-
	      ration file option is make_slide_title_from_caption.

       -L     Do  not  create  thumbnails for text and links (including	video,
	      file and url), but list them as a	text  line  between  thumbnail
	      rows  in	the main gallery index.	 Might be used when the	direc-
	      tory only	contains subgalleries  and  thus  does	not  need  any
	      thumbnail.   The	corresponding  configuration  file  option  is
	      list_links.

       --lang locale
	      Change the locale	used to	translate the text that	 is  automati-
	      cally generated in the HTML pages.  The corresponding configura-
	      tion file	option is language.  Note that the  LANGUAGE  environ-
	      ment variable might prevent this option from working if set.

       --li   Replace  link  labels  in	 slides	(usually Index,	Prev and Next)
	      with images (usually index.png,  prev.png	 and  next.png).   The
	      corresponding  configuration  file options are index_link_image,
	      prev_slide_link_image and	next_slide_link_image.

       --lt   Replace link labels in slides (usually Prev  and	Next)  with  a
	      thumbnail	 to  preview  previous/next  slide.  The corresponding
	      configuration  file  options  are	 prev_slide_link_preview   and
	      next_slide_link_preview.

	      If  passed  together  with  --li,	 thumbnail preview is used for
	      links to previous/next slide while the image is for the link  to
	      the index	is kept.

       -n     Use  the	image  file names for the HTML slide files.  Otherwise
	      the default behavior is to simply	name your slides slide_1.html,
	      slide_2.html, and	so on.

	      The  corresponding configuration file option is make_slide_file-
	      name_from_filename.

       --nc   Omit the image count from	the captions.  The corresponding  con-
	      figuration file option is	slide_counter_format.

       --nf   Omit  the	link from scaled images	in slides to full unscaled im-
	      ages.   The   corresponding   configuration   file   option   is
	      slide_link_to_full_image.

       -p _n_ The  cellpadding	value  of the thumbnail	index tables.  The de-
	      fault is 3.  The corresponding configuration file	option is  in-
	      dex_cellpadding.

       --php  Change  the default extension of generated webpages from html to
	      php.  The	corresponding configuration file option	is  www_exten-
	      sion.

	      Note  that  template  names are not modified and keep their html
	      extension	even if	they contain some PHP code.  Note  that	 llgal
	      will  only remove	existing webpages corresponding	to this	exten-
	      sion when	generating a new gallery or cleaning.

       --parent-gal
	      Add links	to the parent directory.  The corresponding configura-
	      tion file	option is parent_gallery_link.

	      This option is used internally for recursive galleries, and thus
	      not documented in	--help.	 These links are stored	 as  a	header
	      and  a  footer  for  the	index.	The text in the	links might be
	      changed through the parent_gallery_link_text  configuration  op-
	      tion.

       --Rl   Add links	between	subgalleries.  The corresponding configuration
	      file option is link_subgalleries.

       -s     For the simplest setup, omit  all	 HTML  slides.	 Clicking  the
	      thumbnails  on  the  main	page will just take users to the plain
	      image files.  The	corresponding  configuration  file  option  is
	      make_no_slides.

       --sort [rev]_name|iname|size|time|none_
	      Change  sort  criteria when scanning files in the	working	direc-
	      tory.  Default is	"name".	 Setting to  the  empty	 string	 means
	      none.   iname  is	 case  insensitive  sort by names.  date means
	      time.  rev might be added	for reverse sort.   The	 corresponding
	      configuration file option	is sort_criteria.

       --sx _n_
	      Instead  of  using  the  original	 image in the slides, insert a
	      scaled image whose width is less than <n>	 pixels.   The	corre-
	      sponding	configuration  file option is slide_width_max.	Useful
	      if your digital camera spits out large images,  like  1600x1200.
	      Clicking	on the scaled copies in	the HTML slides	lets users see
	      the full unscaled	images.	 The default is	 0  (width  is	unlim-
	      ited).   You  must use -f	to force regeneration of scaled	images
	      if you want to change the	value of --sx.

       --sy _n_
	      Instead of using the original image  in  the  slides,  insert  a
	      scaled  image  whose height is less than <n> pixels.  The	corre-
	      sponding configuration file option is slide_height_max.	Useful
	      if  your	digital	camera spits out large images, like 1600x1200.
	      Clicking on the scaled copies in the HTML	slides lets users  see
	      the  full	 unscaled  images.  The	default	is 0 (height is	unlim-
	      ited).  You must use -f to force regeneration of	scaled	images
	      if you want to change the	value of --sy.

       --templates _dir_
	      Add  a  directory	to the list of template	locations.  The	corre-
	      sponding configuration file option is additional_template_dir.

       --title _s_
	      Substitutes the string _s_ for <!--TITLE--> in the  index.   The
	      default  is  Index  of Pictures.	It overrides the configuration
	      file option index_title_default.

       --tx _n_
	      Scale thumbnails so that their width is at most _n_ pixels.  The
	      default  is 113.	The corresponding configuration	file option is
	      thumbnail_width_max.  If 0 is  used,  the	 width	is  unlimited.
	      Changing	this  value  does  not	affect the maximal height (see
	      --ty).  You must use -f to force regeneration of	thumbnails  if
	      you want to change the value of --tx.

       --ty _n_
	      Scale  thumbnails	 so  that  their height	is at most _n_ pixels.
	      The default is 75.  The corresponding configuration file	option
	      is  thumbnail_height_max.	  Changing  this value does not	affect
	      the maximal width	(see --tx).  You must use -f to	force regener-
	      ation of thumbnails if you want to change	the value of --ty.

       -u     Write image captions under each thumbnail	on the index page.  If
	      you have a captions file,	then the captions are read from	there.
	      The  corresponding configuration file option is show_caption_un-
	      der_thumbnails.

       --uc _url_
	      Assume the CSS file is available on _url_	and thus do not	use  a
	      local one.  If ending with a slash, the CSS filename will	be ap-
	      pended.  The corresponding configuration file option is  css_lo-
	      cation.

       --ui _url_
	      Assume  that  the	 filmtile image	and index/prev/next slide link
	      images are available on _url_ and	thus do	not  use  local	 ones.
	      Their filename will be appended to the given location.  Each im-
	      age location may be also changed independently  (See  CONFIGURA-
	      TION  for	the list of configuration options).  The corresponding
	      configuration file options are filmtile_location,	index_link_im-
	      age_location,	    prev_slide_link_image_location	   and
	      next_slide_link_image_location.

       -w _n_ Set the thumbnail	rows to	be _n_ images wide in the  main	 index
	      file.   Default  is 5.  The corresponding	configuration file op-
	      tion is thumbnails_per_row.

       --wx _n_
	      Set the thumbnail	rows to	be _n_ pixels wide  at	maximum.   The
	      number  of  thumbnails per row, given in -w is reduced if	neces-
	      sary.  The  corresponding	 configuration	file  option  is  pix-
	      els_per_row.   Default  is to honor -w without regard to the re-
	      sulting row width.

       --www  Make all generated files world-readable.	The corresponding con-
	      figuration file option is	www_access_rights.

CAPTIONS
       When  called with --gc llgal generates (or updates if already existing)
       the captions file in the	.llgal/	subdirectory.

       When --gc is not	passed,	if the captions	file exists, llgal will	 auto-
       matically  use  it  to generate slide captions in the gallery.  If cap-
       tions does not exist, llgal generates captions on the fly and use  them
       in the gallery.

       Generating  the	captions file with --gc	before actually	using it makes
       it possible to modify them (especially to add comments) or  change  the
       order of	the slides in the gallery

       IMG: <filename> ---- <caption>
	      defines an image (when omitted, IMG: is the default type).
       MVI: <filename> ---- <linktext> ---- <caption>
	      defines a	movie.
       TXT: <text in slide> ---- <caption>
	      defines a	text slide.
       LNK: <url> ---- <linktext> ---- <caption>
	      defines a	link slide.
       LNKNOSLIDE: <url> ---- <linktext>
	      defines a	direct link to the target, without any slide.
       FIL: <url> ---- <linktext> ---- <caption>
	      defines a	link to	another	file (typically	neither	an image nor a
	      movie)
       DIR: <dir> ---- <linktext> ---- <caption>
	      defines a	subdirectory slide.
       BREAK
	      forces a line break in the row of	thumbnails
       LINE
	      forces a line break in the row of	thumbnails and inserts a hori-
	      zontal line.
       TITLE: <title>
	      defines the title	of the gallery.
       INDEXHEAD: <one header>
	      defines a	header (multiple ones are possible).
       INDEXFOOT: <one footer>
	      defines a	footer (multiple ones are possible).
       PARENT: <linktext>
	      defines the label	of the link to the parent gallery.
       PREV: <linktext>	---- <url>
	      defines the label	of the link to the previous gallery located by
	      _url_.
       NEXT: <linktext>	---- <url>
	      defines the label	of the link to the  next  gallery  located  by
	      _url_.
       REPLACE:	<text> ---- <replacement>
	      adds a substitution to be	applied	to generated HTML pages.

       Note that you can use whatever HTML syntax in the captions.
       Line beginning with a # are ignored.

       When  generating	 a captions file, the captions.header file is inserted
       at the top of the file to detail	the syntax.

CONFIGURATION
       Before parsing command line options, llgal reads	several	 configuration
       files.  It  starts  with	/etc/llgal/llgalrc then	reads $HOME/.llgal/ll-
       galrc and finally the .llgal/llgalrc file in the	gallery	directory.

       Additional configuration	files may also be defined  with	 the  --config
       option.	 These will be parsed during command-line parsing, when	--con-
       fig is met.

       In case of recursive generation (with -R	) in multiple  subdirectories,
       the  system-  and  user-wide  configuration  files  and those passed to
       --config	are taken in account for all galleries.	 However, only the lo-
       cal  .llgal/llgalrc file	is used	for each gallery.  Especially, the one
       in the root gallery directory is	only taken in account when  generating
       the  root gallery, not when generating those in subdirectories.	To use
       a same specific configuration file for the root gallery and all subgal-
       leries, the --config option may be used.

       All  these files	may change llgal configuration in the same way command
       line options do,	and even more.	All following options may also be used
       on the command line through --option 'variable =	value'.

       See also	the manpage of llgalrc or /etc/llgal/llgalrc for details about
       these options and their default values.

THUMBNAILS AND SCALED IMAGES GENERATION
       By default, llgal uses convert to create	thumbnails and	scaled	images
       (the ones that appear in	the slides when	--sx or	--sy was passed).  The
       command lines used to generate those images from	your  original	images
       are defined by the following configuration options:
	      scaled_create_command  =	convert	 --scale _MAXW_x_MAXH_ -- _IN_
	      _OUT_
	      thumbnail_create_command = convert --scale _MAXW_x_MAXH_ -- _IN_
	      _OUT_

       You may change the value	of these options to change the way the genera-
       tion is done.  <IN> and <OUT> will be replaced by llgal at runtime with
       the filename of the original and	generated target images.

       <MAXW>  and  <MAXH> will	be replaced by the maximal width and length of
       the generated images.  Note that	one of them might not be limited  (de-
       pending	on  other configuration	variable), making it be	replaced by an
       empty string, eventually	leading	to empty parameters  being  passed  to
       your  program.	If  your program does not like that, you might want to
       create a	wrapper	shell script which will	take care of accepting	these.
       Another	solution  would	be to replace unlimited	with limited by	a huge
       value in	your configuration and adapt your program to deal with it.

TEMPLATES
       When generation web pages, the following	fields will be	replaced  from
       the templates by	the associated value (computed by llgal).

       <!--TITLE-->
	      The title	of the index.
       <!--CSS-->
	      The CSS style-sheet.
       <!--CREDITS-->
	      The credits line given by	credits_text configuration option.
       <!--VERSION-->
	      The version of the program used to generate the gallery.
       <!--INDEX-FILE-->
	      The  filename  of	 the  index to used in <a href=""> attributes.
	      May also contain additional  attributes  to  be  appended	 after
	      href.
       <!--INDEX-LINK-TEXT-->
	      The label	of the link to the index (might	be an image).
       LLGAL-CODESET
	      The character encoding, usually set to iso-8859-1	or utf-8.
       LLGAL-OPTIONS
	      The  options  that  were	passed to llgal	on the command line to
	      generate the gallery.

       When generating the index from template indextemplate.html, the follow-
       ing additional fields will also be replaced.

       <!--HEADERS-->
	      The list of headers that are given in the	captions file.
       <!--FOOTERS-->
	      The list of footers that are given in the	captions file.

       When  generating	slides from template slidetemplate.html, the following
       additional fields will also be replaced.

       <!--SLIDE-TITLE-->
	      The title	of the slide.
       <!--THIS-SLIDE-STYLE-->
	      The style	of the slide contents (is defined in  the  CSS	style-
	      sheet).
       <!--SLIDE-NUMBER-->
	      The index	of the slide, with leading zeros.
       <!--SLIDE-TOTAL-->
	      The amount of slides.
       <!--SLIDE-COUNTER-->
	      The  slide  counter  according to	slide_counter_format as	in the
	      caption.
       <!--IMAGE-CAPTION-->
	      The caption of the slide.
       <!--EXIF-TABLE-->
	      The table	of EXIF	tags.
       <!--EXIF-%tag%-->
	      The value	of the image EXIF tag %tag%.  The tag name %tag%  must
	      match  the  name	reported  by exiftool -s myimage.  Note	that a
	      single replacement may be	performed per template line.
       <!--THIS-SLIDE-->
	      The actual contents of the slide (might be an image).
       <!--PREV-SLIDE--> and <!--NEXT-SLIDE-->
	      The filename of the previous and next slides.
       <!--NEXT-SLIDE-LINK-TEXT--> and <!--PREV-SLIDE-LINK-TEXT-->
	      The label	of the link to previous	and next slides	(might	be  an
	      image).

       Additionally,  it  is  possible to define use custom fields in the tem-
       plates and define their replacement with	some REPLACE  entries  in  the
       captions	file.  See CAPTIONS for	details.

       When modifying the templates, beware that the HTML syntax requires dou-
       ble-quotes around filenames, URL, etc. These double-quotes  will	 never
       be  automatically  added	 when replacing	these automatic	variables.  So
       you must	keep double-quotes around variables when needed, for instance:
	      <a href="<!--NEXT-SLIDE-->"><!--NEXT-SLIDE-LINK-TEXT--></a>
       will be changed into
	      <a href="slide_04.html">Next slide</a>

LANGUAGE
       The language that llgal uses to generate	text in	HTML pages  is	chosen
       from  the localization configuration.  If the chosen language is	avail-
       able in llgal translations, it will be used instead of the default eng-
       lish.

       As usual	with gettext, it is possible to	override the localisation con-
       figuration by changing LANG, LC_MESSAGES	or LANGUAGE environment	 vari-
       ables.

       If  the	desired	language is not	available in llgal translations, or if
       the user	wishes to change the text values, he  might  create  an	 addi-
       tional configuration file (or modify the	system-wide one) to update all
       configuration options of	the Text section.

       The locale configuration	might be overridden with the --lang option  or
       language	 configuration option.	But, the LANGUAGE environment variable
       appears to prevent this from working if set.

CHARACTER ENCODING
       If a filename contains non-ascii	characters which are not safely	repre-
       sentable	 in  a	URL,  llgal will escape	them using the method RFC 2396
       specifies.  This	may raise problems if the web server has  a  different
       notion  of character encoding than the machine llgal runs on.  See also
       http://www.w3.org/TR/html4/appendix/notes.html#h-B.2

       Character encoding is chosen from the locale configuration and  set  in
       the HTML	headers.  It may be overridden by using	--codeset or the code-
       set configuration option.

NOTES
       Note that all numerical options may be reset to their default value  by
       setting them a negative value.

FILES
       /etc/llgal/llgalrc, $HOME/.llgal/llgalrc, .llgal/llgalrc
	      System-wide, per-user and	local configuration files. See CONFIG-
	      URATION for details.
       /usr/share/llgal/captions.header
	      Captions syntax description file that is inserted	at the top  of
	      generated	captions file.
       /usr/share/llgal/llgal.css
	      The default style-sheet template.
       /usr/share/llgal/tile.png
	      The tiled	image used for the film	effect.
       /usr/share/llgal/index.png
	      The link image used for the index.
       /usr/share/llgal/prev.png
	      The link image used for the previous slide.
       /usr/share/llgal/next.png
	      The link image used for the next slide.
       All files are required on the website.  llgal will copy them to the lo-
       cal .llgal/ file	during gallery generation.

       /usr/share/llgal/indextemplate.html
	      The default index	template file.
       /usr/share/llgal/slidetemplate.html
	      The default file used to generate	slides.
       These files are not required on the website.  But, llgal	will use  them
       to  generate  HTML  webpages of the gallery by replacing	several	fields
       with text or images.  See TEMPLATES for details.

       The user	may change all these templates by storing files	with the  same
       name  in	its user template directory $HOME/.llgal/ or in	the local .ll-
       gal/ directory.	The former defines user-specific templates  that  will
       be  used	 each  time  the  user	generate a gallery.  The later defines
       gallery-specific	templates that will be used for	the local gallery.   A
       local  template	is  used  by default if	it exists.  A user template is
       used if it exists and no	local template exists.	 Finally,  system-wide
       templates are used if no	local and user templates override them.

       It  is  also  possible  to add custom template directories (with	--tem-
       plates) that will be used to get	templates before trying	 in  the  user
       and in the system-wide template directories.

       The  option  --gt  might	be used	to get copies of template files	in the
       local or	in the user template directory.

EXAMPLES
       Run llgal in a directory	with jpg, gif, png, mpg	or avi	files  to  see
       what it does.  Then play	with the options described above and use -h if
       you need	a quick	listing.

BUGS
       There are always	some.  If you find any let me know.

SEE ALSO
       llgalrc(5)

AUTHOR
       Brice Goglin

				 NOVEMBER 2006			      LLGAL(1)

NAME | SYNOPSIS | DESCRIPTION | BEHAVIOR OPTIONS | ADDITIONAL BEHAVIOR OPTIONS | SELECTING FILES | LAYOUT OPTIONS | CAPTIONS | CONFIGURATION | THUMBNAILS AND SCALED IMAGES GENERATION | TEMPLATES | LANGUAGE | CHARACTER ENCODING | NOTES | FILES | EXAMPLES | BUGS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=llgal&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help