You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
2.4 KiB
Plaintext
65 lines
2.4 KiB
Plaintext
12 years ago
|
**** UNDER CONSTRUCTION ****
|
||
|
|
|
||
|
|
The website/ directory contains the source code required to build the
|
||
|
|
web pages for exiv2.org as well as scripts to build exiv2 releases.
|
||
|
|
|
||
|
|
How to build the website
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
- Build and install exiv2, build the samples and doc. And while you're
|
||
|
|
at it, it never hurts to also run the tests.
|
||
|
|
- Build bin/rssdate from the source file bin/rssdate.cpp
|
||
|
|
- Define the environment variable EXIV2HOME to the path of your exiv2
|
||
|
|
directory, i.e., the parent directory of website/
|
||
|
|
- Run 'make update' to import whatever is required from the rest of the
|
||
|
|
exiv2 sources (doc/, samples/, src/)
|
||
|
|
- Run 'make' to build the web pages
|
||
|
|
|
||
|
|
Subsequently, 'make clean; make' will remove and rebuild the web
|
||
|
|
pages; 'make update' is only needed if something changed in the exiv2
|
||
|
|
source or doc.
|
||
|
|
|
||
|
|
Dependencies
|
||
|
|
------------
|
||
|
|
|
||
|
|
- python
|
||
|
|
- doxygen-1.5.4 must be available in the path with this name
|
||
|
|
- xsltproc
|
||
|
|
- ps2pdf
|
||
|
|
- man2html
|
||
|
|
- ...
|
||
|
|
|
||
|
|
Generated HTML pages
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
Master HTML files
|
||
|
|
To modify HTML content, change the master HTML files master/*.in.
|
||
|
|
Do _not_ change the html/*.html files. These are generated files.
|
||
|
|
|
||
|
|
Placeholders
|
||
|
|
The master HTML files contain placeholders for HTML code that is
|
||
|
|
common to multiple files. Placeholders are strings of the form
|
||
|
|
__placeholder__. The content for each placeholder is in a file
|
||
|
|
var/__placeholder__. A special placeholder is __last_modified__: It
|
||
|
|
doesn't need a corresponding file in the var/ directory to be
|
||
|
|
substituted. Instead, every occurrence of __last_modified__ is
|
||
|
|
automatically replaced with the current date.
|
||
|
|
|
||
|
|
Substitution of placeholders
|
||
|
|
A small Python script bin/gen.py performs the substitutions. Variables
|
||
|
|
are substituted in one pass, in alphabetical order. Thus variables in
|
||
|
|
the content of another placeholder only get substituted if their names
|
||
|
|
are greater than the name of the containing placeholder. The special
|
||
|
|
variable __last_modified__ is substituted after all regular
|
||
|
|
placeholders, so it can occur in the content of any other placeholder.
|
||
|
|
|
||
|
|
News
|
||
|
|
The file news.xml contains all news items. There are two stylesheets
|
||
|
|
(whatsnew-table.xsl, whatsnew-latest.xsl) which are used to create
|
||
|
|
placeholders __whatsnew-table__ and __whatsnew-latest__. To add or
|
||
|
|
change news items, only change the news.xml masterfile and run make.
|
||
|
|
|
||
|
|
Makefile
|
||
|
|
To re-generate the HTML pages from the master files and move them
|
||
|
|
to the html/ directory, run "make" in this directory
|