==============================================================================================================================
How to install Publican and produce pdf and html files in various translated languages | Dimitris Tzemos <djemos@slackel.gr>
==============================================================================================================================

files including this guide are on http://people.salixos.org/djemos/startup-guide/files-fonts/



A. Installation of Publican and deps
=====================================


A1. Installation of publican

Just run as root 

 For Slackware 13.37
 publican-install-slackware-13.37.sh (download from http://people.salixos.org/djemos/startup-guide/files-fonts/publican-install-slackware-13.37.sh)

 For Slackware 14.0 
 publican-install-slackware-current.sh (download from http://people.salixos.org/djemos/startup-guide/files-fonts/publican-install-slackware-14.0.sh)

 For Slackware current 
 publican-install-slackware-current.sh (download from http://people.salixos.org/djemos/startup-guide/files-fonts/publican-install-slackware-current.sh)

A2. 	Download from svn startup-guide
	svn co https://salix.svn.sourceforge.net/svnroot/salix/startup-guide/trunk/
  A2.1 	Enter inside trunk folder
	cd trunk
  A2.3 	As root, Move publican-SalixOS to /usr/share/publican/Common_Content
	mv publican-SalixOS /usr/share/publican/Common_Content


A3. Then go in file /usr/share/publican/xsl/defaults.xsl
    and turn draft mode off to not appear the druft background image in every pdf page.
    To turn draft mode off, 
    change yes to no in line 49 of /usr/share/publican/xsl/defaults.xsl 
    like bellow.
    <xsl:param name="draft.mode">no</xsl:param>

       rm salix-startup-guide/en-US/Feedback.xml
       rm salix-startup-guide/en-US/Legal_Notice.xml
    FeedBack.xml will appear on el_GR language and all other languages translated and not in english
    These files already exist on /usr/share/publican/Common_Content/publican-SalixOS/en-US/

B. Produce pdf and html docs
=============================

B1.  Now run from trunk directory as normal user
      publican build --langs=en-US --formats=pdf,html 
 
     You will find the pdf in tmp folder under trunk folder

B2. 
  B2.1 To build pdf's in other languages (e.g greek) 
       move or copy el-GR folder under /usr/share/publican/Common_Content/publican-SalixOS to /usr/share/publican/Common_Content/common
       mv /usr/share/publican/Common_Content/publican-SalixOS/el-GR /usr/share/publican/Common_Content/common

       The el-GR folder has the 3 translated files in greek. Legal_Notice.xml, Feedback.xml, Conventions.xml
       The same has to be done for every language file 

  B2.2 Run build --langs=el-GR --formats=pdf,html  to create greek pdf and html


      or run

      publican build --langs=en-US,el-GR --formats=html,pdf 
      to create html and pdf for en-US and el-GR langs


B3. 
    B3.1 Upload your pdf files in a dir in your server
    B3.2 Upload the folder html under tmp in the trunk directory on your web server and put a link in your web page so users can visit and read the guide.
          e.g for Greek pdf file  http://people.salixos.org/djemos/startup-guide/pdf/el-GR/SalixOS-13.37-Startup_Guide-el-GR.pdf
              for Greek html pages   http://people.salixos.org/djemos/startup-guide/el/
              for English pdf file   http://people.salixos.org/djemos/startup-guide/pdf/en-US/SalixOS-13.37-Startup_Guide-en-US.pdf
	      for English html pages http://people.salixos.org/djemos/startup-guide/en-US


Dimitris