Fontlinge ist work in _heavy_ progress.

This code is developed with and for Linux.


 For "How to install" see the 'INSTALL'-file

                    or

          http://www.gesindel.de



The old win-version is not developed anymore, 
but can be downloaded there.



--------------------------------------------------

Possible options and parameters in ~/.fontlinge are:


# webgui_path=/home/ratti/public_html/fontlinge
Directory containing the webbased graphical interface.

# webgui_conf=/home/ratti/public_html/fontlinge/config.inc.php
Config-file for the webbased graphical interface.

# webgui_unsorted
If you own LOTS of fonts, you can advice the web gui not to sort them.
This improves speed - and if you have created the database, the files
are sorted by name anyway.


# mysqlserver=localhost
# database=fontlinge
# username=secret
# password=secret
Usual mysql parameters.


# tmp_as_folder=/tmp
Directory to be used for tempfiles.

# tarpath=/bin/tar
The webgui needs tar for creating download-archives.

# sortername=ratti
If you want to sort fonts in categories and share them with others,
this name will be written into the database to identify your entries.

# trusted_sorters=core,ratti
See sortername. These IDs are "trusted" as coming from the Fontlinge
maintainers. This is not a security configuration. We can "bugfix" fonts
sorted into wrong categories.
The listed sorters are allowed to overwrite existing entries if both
new and existing entry are from a trusted sorter - even without
--overwrite-duplicates in fontlinge_database_assistant.
Example: "core" may overwrite entries from "ratti", but "core" will not
overwrite "yourname" entries (as long as "yourname" is not listed as
trusted sorter).


# webgui_download_filename=realname
If you use the webgui as a public webpage and dont't want your complete
font-collection "leeched empty" by brute-force-downloaders, then use this 
parameter.

Set this parameter to "realname" (or do not set it at all) to name the
downloaded fonts like the font itself, i.e.:
hellvetica.tar.gz
arial.tar.gz
vera.tar.gz

Otherwise set it to i. e. "font.tar.gz". EVERY download then will be
called "font.tar.gz" (or how you called it). Setting this parameter 
will NOT keep someone from causing lots of traffic. But the result will
be possibly less useful for him. A good mirroring tool will not be 
impressed by this.



# webgui_suffixes=green,big,small
If you created muliple previews per font, i.e. "arial.big.png" , 
"arial.small.png", "arial.green.png", you can configure the
webgui to let the user choose one.


#fontbase=/disk4/fontbase.bastel/
If you don't want the fontbase in ~/fontbase, you can choose a different
path here.


EXPERIMENTAL FEATURE
# my_code=/home/ratti/HEAD/scripts/my_code.pl
EXPERIMENTAL FEATURE

This works for us, but is NOT widely tested. Please feedback if it works/
doesn't work for you.

If you are a coder, you can "replace" internal functions of the Fontlinge
commands and module with your own. You can create different paths, different 
filenames, different sorting, different whatever stuff by pointing this
parameter to a file with your code.

An example for "my_code.pl" is delivered in the archive (and installed into 
documentation directory):

ratti@ratti> grep "^sub" scripts/my_code.pl
sub MY_fontlinge_Percent {
sub MY_fontlinge_Create_Image {
sub MY_fontlinge_Imagename {

This lets Fontlinge run with different image types and names. It even
draws a different process bar when using the "--percent" option.

If you write a nice include - send it in! Maybe it's worth to be included
in the package or even in the main program.





# perl5lib=/home/yourname/perllib

If you are installing as non-root, you have to configure the path where you
installed the perl libs to. This config file setting is only used in the
webinterface detail preview.
The Fontlinge commands need a separate setting, see INSTALL, section
"non-root installation".


# apache_user=wwwrun

The username running your webserver (mostly Apache). Common usernames are
wwwrun, www-data, httpd or apache.
The username is needed to secure the Fontlinge config file. Please note that
your filesystem must support ACL to limit read access to the configfile.

