r4548 - in trunk/BOOK: . introduction/welcome postlfs/editors

bdubbs at linuxfromscratch.org bdubbs at linuxfromscratch.org
Sun Jun 5 11:51:47 PDT 2005


Author: bdubbs
Date: 2005-06-05 12:51:46 -0600 (Sun, 05 Jun 2005)
New Revision: 4548

Added:
   trunk/BOOK/postlfs/editors/bluefish.xml
Modified:
   trunk/BOOK/Makefile
   trunk/BOOK/README
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
   trunk/BOOK/postlfs/editors/editors.xml
Log:
Added bluefish from patch from theOldFellow; updated Makefile and README

Modified: trunk/BOOK/Makefile
===================================================================
--- trunk/BOOK/Makefile	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/Makefile	2005-06-05 18:51:46 UTC (rev 4548)
@@ -19,7 +19,7 @@
 	@if [ -z $(BASEDIR) ]; then \
 		echo "Envar BASEDIR is not set!" ; \
 		exit 1 ; \
-		fi
+	fi
 	@echo "Generating XHTML Version of BLFS Book with xsltproc..."
 	@echo "  BASEDIR = $(BASEDIR)"
 	@$(INSTALL) -d $(BASEDIR)
@@ -41,7 +41,7 @@
 	@echo "Generating nochunks version of BLFS..."
 	xsltproc --xinclude --nonet -stringparam profile.condition html \
         --output $(BASEDIR)/$(NOCHUNKS_OUTPUT) \
-          stylesheets/blfs-nochunks.xsl index.xml
+        stylesheets/blfs-nochunks.xsl index.xml
 
 	tidy -config tidy.conf $(BASEDIR)/$(NOCHUNKS_OUTPUT) || true
 
@@ -50,39 +50,29 @@
 
 pdf:
 	xsltproc --xinclude --nonet --output blfs.fo \
-	stylesheets/blfs-pdf.xsl \
-	  index.xml
+	  stylesheets/blfs-pdf.xsl index.xml
 	sed -i -e "s/inherit/all/" blfs.fo
 	fop.sh blfs.fo blfs.pdf
 	$(INSTALL) -d $(BASEDIR)pdf
 	rm blfs.fo
 	mv blfs.pdf $(BASEDIR)pdf
 
-print:
-	xsltproc --xinclude --nonet --output blfs-print.fo \
-	stylesheets/blfs-print.xsl index.xml
-	sed -i -e "s/inherit/all/" blfs-print.fo
-	fop.sh blfs-print.fo blfs-print.pdf
-	$(INSTALL) -d $(BASEDIR)print
-	rm blfs-print.fo
-	mv blfs-print.pdf $(BASEDIR)print
-
 tex:
 	@if [ -z $(TEXBASEDIR) ]; then \
-                echo "Envar TEXBASEDIR is not set!" ; \
-                exit 1 ; \
-                fi
+       echo "Envar TEXBASEDIR is not set!" ; \
+       exit 1 ; \
+    fi
 	@echo "Generating TeX Version of BLFS Book with xsltproc..."
 	@echo "  TEXBASEDIR = $(TEXBASEDIR)"
 	@$(INSTALL) -d $(TEXBASEDIR)
 # Using profiles in book source to exclude parts of the book from TeX
 # i.e., Changelog
 	xsltproc --nonet --output $(TEXBASEDIR)index.xml \
-	--stringparam "profile.role" "book" \
+    	--stringparam "profile.role" "book" \
 	http://docbook.sourceforge.net/release/xsl/current/profiling/profile.xsl \
-	index.xml
+	    index.xml
 	@cd $(TEXBASEDIR) && xsltproc --nonet -o blfs-book.tex \
-	$(SRCDIR)/stylesheets/blfs-tex.xsl index.xml
+	    $(SRCDIR)/stylesheets/blfs-tex.xsl index.xml
 
 validate:
 	xmllint --noout --nonet --xinclude --postvalid index.xml

Modified: trunk/BOOK/README
===================================================================
--- trunk/BOOK/README	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/README	2005-06-05 18:51:46 UTC (rev 4548)
@@ -2,46 +2,19 @@
 and TXT? You need to have some software installed that deal with these
 conversions. Please read the INSTALL file to determine what programs
 you need to install and where to get instructions to install that software.
-Then come back to this file for examples how to convert these files
-into various other formats.
 
-These instructions are also incorporated in the Makefile.
+After that, you can build the html with a simple 'make' command.
+The default target builds the html in $(HOME)/public_html/blfs-book.
 
-XML to HTML:
-------------
-Create a directory in which you want to store the HTML files: ~/blfs-html
-Change to the top of the directory where the xml code is located.
-Now run:
-  BASEDIR="~/blfs-html"
-  xsltproc --xinclude --nonet -stringparam base.dir $(BASEDIR) \
-     stylesheets/blfs-chunked.xsl index.xml
-  mkdir -p $(BASEDIR)stylesheets $(BASEDIR)images
-  cp stylesheets/*.css $(BASEDIR)stylesheets
-  cp images/*.png $(BASEDIR)/images
-  sed -i -e "s at ../stylesheets at stylesheets@g" $(BASEDIR)/*.html
-  sed -i -e "s at ../images at images@g" $(BASEDIR)/*.html
-  sh goTidy $(BASEDIR)/
+Other Makefile targets are: nochunks, pdf, tex, validate, and
+blfs-patch-list.
 
+nochunks: builds BLFS in one huge file.
 
-XML to NOCHUNKS-HTML:
---------------------
-The NOCHUNKS HTML version is one big HTML file:
-  xsltproc --xinclude --nonet -stringparam profile.condition html \
-     --output $(BASEDIR)/BLFS-BOOK.html stylesheets/blfs-nochunks.xsl index.xml
-  tidy -config tidy.conf $(BASEDIR)/BLFS-BOOK.html
-  sed -i -e "s at text/html at application/xhtml+xml at g" $(BASEDIR)/BLFS-BOOK.html
+pdf: builds BLFS as a pdf file.
 
-XML to TXT:
------------
-First create the NOCHUNKS HTML file, then convert by running:
-	/usr/bin/lynx -dump nochunks.html > output.txt
+tex: converts the xml files to tex files
 
-XML to PDF:
-------------------
-xsltproc --xinclude --nonet --output blfs.fo stylesheets/blfs-pdf.xsl index.xml
-sed -i -e "s/inherit/all/" blfs.fo
-fop.sh blfs.fo blfs.pdf
-mkdir -p  $(BASEDIR)/pdf
-rm blfs.fo
-mv blfs.pdf $(BASEDIR)/pdf
+validate:  does an extensive check for xml errors in the book.
 
+blfs-patch-list: generates a list of all blfs controlled patches in the book.

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/general.ent	2005-06-05 18:51:46 UTC (rev 4548)
@@ -1,4 +1,4 @@
-<!ENTITY day          "04">
+<!ENTITY day          "05">
 <!ENTITY month        "06">
 <!ENTITY year         "2005">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -51,6 +51,7 @@
 <!ENTITY nano-version                 "1.2.4">
 <!ENTITY joe-version                  "3.1">
 <!ENTITY ed-version                   "0.2">
+<!ENTITY bluefish-version             "1.0.1">
 
 <!-- Chapter 7 -->
 <!ENTITY ash-version                  "0.4.0">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-06-05 18:51:46 UTC (rev 4548)
@@ -25,6 +25,11 @@
   <itemizedlist>
 
     <listitem>
+      <para>June 5th, 2005 [bdubbs]: Added blufish-1.0.1 from patch
+      provided by theOldFellow.</para>
+    </listitem>
+
+    <listitem>
       <para>June 4th, 2005 [randy]: Standardized the creation of the nobody
       user (without a valid login shell) in the NFS Utilities and Postfix
       instructions.</para>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/introduction/welcome/credits.xml	2005-06-05 18:51:46 UTC (rev 4548)
@@ -314,6 +314,11 @@
         <emphasis>Jim Gifford</emphasis></para>
       </listitem>
 
+      <listitem>
+        <para>bluefish:
+        <emphasis>theOldFellow</emphasis></para>
+      </listitem>
+
     </itemizedlist>
 
   </sect2>

Added: trunk/BOOK/postlfs/editors/bluefish.xml
===================================================================
--- trunk/BOOK/postlfs/editors/bluefish.xml	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/postlfs/editors/bluefish.xml	2005-06-05 18:51:46 UTC (rev 4548)
@@ -0,0 +1,143 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY bluefish-download-http "http://pkedu.fbt.eitn.wau.nl/~olivier/downloads/bluefish-&bluefish-version;.tar.bz2  ">
+  <!ENTITY bluefish-download-ftp  "ftp://ftp.ratisbona.com/pub/bluefish/downloads/bluefish-&bluefish-version;.tar.bz2">
+  <!ENTITY bluefish-md5sum        "a3cf8abd282d850407e8c7eed38d15e7">
+  <!ENTITY bluefish-size          "1.4 MB">
+  <!ENTITY bluefish-buildsize     "23.7 MB">
+  <!ENTITY bluefish-time          "0.3 SBU">
+]>
+
+<sect1 id="bluefish">
+  <?dbhtml filename="bluefish.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Bluefish-&bluefish-version;</title>
+
+  <indexterm zone="bluefish">
+    <primary sortas="a-Bluefish">Bluefish</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Bluefish</title>
+
+    <para>The <application>bluefish</application> package contains a powerful X
+    Window System editor designed for web designers, but which is also suitable
+    as a programmer's editor.  Bluefish supports many programming and markup
+    languages, and as such is ideal for editing xml and html files.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&bluefish-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&bluefish-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &bluefish-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &bluefish-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &bluefish-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &bluefish-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Bluefish Dependencies</bridgehead>
+   <bridgehead renderas="sect4">Required</bridgehead>
+    <para><xref linkend="gtk2"/> <xref linkend="pcre"/></para>
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para><xref linkend="gnome-vfs"/> (for remote files) 
+          <xref linkend="aspell"/> (for spellchecking)</para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Bluefish</title>
+
+    <para>Install <application>bluefish</application> by running the following
+    commands:</para>
+
+<screen><userinput>./configure --prefix=/usr &&
+make</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install
+</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Bluefish</title>
+
+    <sect3 id="bluefish-config">
+      <title>Config Files</title>
+
+      <para> Directory <filename>~/.bluefish</filename></para>
+
+      <indexterm zone="bluefish bluefish-config">
+        <primary sortas="e-AA.bluefish">~/.bluefish</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>The directory ~/.bluefish is created by the program when it is
+      first run, and the configuration files are maintained by the program
+      automatically to preserve settings from run to run.</para>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directory</segtitle>
+
+      <seglistitem>
+        <seg>bluefish</seg>
+        <seg>None</seg>
+        <seg>/usr/share/bluefish</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="bluefish-prog">
+        <term><command>bluefish</command></term>
+        <listitem>
+          <para>is an X Window System editor for markup and programming.</para>
+          <indexterm zone="bluefish bluefish-prog">
+            <primary sortas="b-bluefish">bluefish</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/postlfs/editors/bluefish.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedDate Author

Modified: trunk/BOOK/postlfs/editors/editors.xml
===================================================================
--- trunk/BOOK/postlfs/editors/editors.xml	2005-06-04 20:05:01 UTC (rev 4547)
+++ trunk/BOOK/postlfs/editors/editors.xml	2005-06-05 18:51:46 UTC (rev 4548)
@@ -20,6 +20,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nano.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="joe.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ed.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bluefish.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="others.xml"/>
 
 </chapter>




More information about the blfs-book mailing list