[Debian-NP-Commits] r191 - trunk/docs/report/report-docbook

Mon, 04 Oct 2004 22:41:16 -0600

Author: mako
Date: Mon Oct  4 22:41:15 2004
New Revision: 191

Added:
   trunk/docs/report/report-docbook/Makefile
Modified:
   trunk/docs/report/report-docbook/README.txt
   trunk/docs/report/report-docbook/accomplishments.xml
   trunk/docs/report/report-docbook/appendix-cdd.xml
   trunk/docs/report/report-docbook/appendix-development_environment.xml
   trunk/docs/report/report-docbook/appendix-installer.xml
   trunk/docs/report/report-docbook/final-personas.xml
   trunk/docs/report/report-docbook/future.xml
   trunk/docs/report/report-docbook/intro.xml
   trunk/docs/report/report-docbook/report-master.xml
   trunk/docs/report/report-docbook/social_spec.xml
Log:
a bunch of work that get the report buildable. i'm not sure that the
instructions willl actually let people build the stuff though. need to
make sure that the package list is alright.


Added: trunk/docs/report/report-docbook/Makefile
==============================================================================

--- (empty file)
+++ trunk/docs/report/report-docbook/Makefile	Mon Oct  4 22:41:15 2004
@@ -0,0 +1,11 @@
+
+html:
+	mkdir html
+	xmlto -o html xhtml report-master.xml
+
+onehtml:
+	mkdir html
+	xmlto -o html html-nochunks report-master.xml
+
+clean:
+	rm -rf ./html

Modified: trunk/docs/report/report-docbook/README.txt
==============================================================================
--- trunk/docs/report/report-docbook/README.txt	(original)
+++ trunk/docs/report/report-docbook/README.txt	Mon Oct  4 22:41:15 2004
@@ -1,4 +1,34 @@
-I've divded up the report into the same divisions as are in the open
+NOTES
+-----
+
+The calendar file is empty and is not being built. I've removed
+references to it.
+
+
+RENDERING BUILDING DOCUMENT INFORMATION
+----------------------------------------
+
+I've provided a makefile that will output the document in formats that
+you will probably be interested in.
+
+You will need the following packages installed:
+
+  xmlto docbook-xsl-stylesheets docbook-xsl passivetex
+
+With these installed, you will probably want to run one of the
+following command to output HTML:
+
+ $ make html
+
+To output HTML in multiple pages, use the following command:
+
+ $ make onehtml
+
+
+AUTHORING DOCUMENT INFORMATION
+--------------------------------
+
+I've divided up the report into the same divisions as are in the open
 office document to make this all a whole lot easier. When creating a
 new one, please use intro.xml as a reference. It uses many, but
 potentially not all, of the docbook elements that you will need.
@@ -28,7 +58,7 @@
   http://www.docbook.org/tdg/en/
 
 If you're looking for an example, feel free to download a HOWTO Mako
-has written in Docbook (SGML, but it's *reallty* similar) here:
+has written in DocBook (SGML, but it's *really* similar) here:
 
   http://mako.yukidoke.org/projects/howto/FreeSoftwareProjectManagement-HOWTO.sgml.gz
 

Modified: trunk/docs/report/report-docbook/accomplishments.xml
==============================================================================
--- trunk/docs/report/report-docbook/accomplishments.xml	(original)
+++ trunk/docs/report/report-docbook/accomplishments.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <sect1>
  <title>Accomplishments</title>
 

Modified: trunk/docs/report/report-docbook/appendix-cdd.xml
==============================================================================
--- trunk/docs/report/report-docbook/appendix-cdd.xml	(original)
+++ trunk/docs/report/report-docbook/appendix-cdd.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <appendix>
  <title>Appendix D: Customized Debian Distributions (CDD)</title>
  <sect1>
@@ -275,4 +272,4 @@
 sgml-indent-data:1
 sgml-set-face:t
 End:
--->
\ No newline at end of file
+-->

Modified: trunk/docs/report/report-docbook/appendix-development_environment.xml
==============================================================================
--- trunk/docs/report/report-docbook/appendix-development_environment.xml	(original)
+++ trunk/docs/report/report-docbook/appendix-development_environment.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <appendix>
  <title>Appendix C: Development Environment</title>
  <sect1>

Modified: trunk/docs/report/report-docbook/appendix-installer.xml
==============================================================================
--- trunk/docs/report/report-docbook/appendix-installer.xml	(original)
+++ trunk/docs/report/report-docbook/appendix-installer.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <appendix>
  <title>Appendix E: Debian-NP Installer</title>
  <sect1>
@@ -170,4 +167,4 @@
 sgml-indent-data:1
 sgml-set-face:t
 End:
--->
\ No newline at end of file
+-->

Modified: trunk/docs/report/report-docbook/final-personas.xml
==============================================================================
--- trunk/docs/report/report-docbook/final-personas.xml	(original)
+++ trunk/docs/report/report-docbook/final-personas.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <sect1>
   <title>Appendix B: Personas</title>
 
@@ -75,7 +72,7 @@
     <term>Ingrid Kristiansen</term>
     <listitem> 
 
-      <para>Ingrid is 40 years old, lives in Århus (DK) and works with young
+      <para>Ingrid is 40 years old, lives in Ã…rhus (DK) and works with young
       children in a kindergarten; in her free time she works as a volunteer in
       the local Fair Trade shop.</para>
 
@@ -110,7 +107,7 @@
   
       <para>Carla Maria, 38 years, is the mother of a young boy affected with
       Down Syndrome.  Years ago, after she learnt about the condition of her
-      baby, she reacted becoming very active in the Asociatión Padres Trisomia
+      baby, she reacted becoming very active in the AsociatiÃ³n Padres Trisomia
       21, one of the Spanish associations of parents of children with Down
       syndrome.</para>
   

Modified: trunk/docs/report/report-docbook/future.xml
==============================================================================
--- trunk/docs/report/report-docbook/future.xml	(original)
+++ trunk/docs/report/report-docbook/future.xml	Mon Oct  4 22:41:15 2004
@@ -1,13 +1,10 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <sect1>
   <title>The Future</title>
   
   <sect2>
     <title>Debian-NP GNU/Linux Distributions</title> 
     
-    <para>The Debian-NP Bagunça team has actively continued work on
+    <para>The Debian-NP BagunÃ§a team has actively continued work on
     the projects described in the rest of the document. The future
     will undoubtedly see continuing work on these projects initiated
     during DebConf. As only one example, an installable version of

Modified: trunk/docs/report/report-docbook/intro.xml
==============================================================================
--- trunk/docs/report/report-docbook/intro.xml	(original)
+++ trunk/docs/report/report-docbook/intro.xml	Mon Oct  4 22:41:15 2004
@@ -1,10 +1,5 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <sect1>
- <title>Introduction</title>
-
- <para>In its first year, the Debian-NP project has built a unique
+<para>In its first year, the Debian-NP project has built a unique
   community networking representatives of non-profit organizations
   with Free and Open Source software geeks involved and interested in
   sering non-profits. While the project coordinated the successful
@@ -54,14 +49,14 @@
 
  <para>Using a Portuguese term for <quote>mess,</quote> with wholly
   positive connotations, the group dubbed the meeting the Debian-NP
-  Bagunça. A bagunça is a fun type of mess, somewhat equivalent in
+  BagunÃ§a. A bagunÃ§a is a fun type of mess, somewhat equivalent in
   translation to a stew with many individual ingredients thrown
   together and mixed around to create something delicious. The meeting
   lived up to its name. The goals of the meeting were ambitious both
   in their scope and the extent; rushing toward these goals,
   intrepidly and in every direction, although the group wasn't sure
   which direction to go at all times, the results, like any
-  bagunça, were wholly positive.</para>
+  bagunÃ§a, were wholly positive.</para>
 
  <para>Debian-NP made steps forward in numerous directions and beyond
   our more optimistic projections. Advances in any single area &mdash;
@@ -181,9 +176,9 @@
   </sect3>
 
   <sect3>
-   <title>Debian-NP Bagunça @ Debconf 4</title>
+   <title>Debian-NP BagunÃ§a @ Debconf 4</title>
 
-   <para>The Debian-NP Bagunça occurred within DebConf4 (both
+   <para>The Debian-NP BagunÃ§a occurred within DebConf4 (both
     temporaly and within the same space. As a result, Debian-NP
     developers were able to use the proximity of other Debian
     developers, as well as the benefits derived from in-person focused
@@ -373,7 +368,7 @@
 
   <para>Most participants attended for the duration of Debconf (seven
    days). Many stayed longer to participate and attend FISL (<ulink
-    url="http://www.softwarelivre.org/forum2004/">5° Fórum
+    url="http://www.softwarelivre.org/forum2004/">5Â° FÃ³rum
     Internacional de Software Livre</ulink>).</para>
  </sect2>
 
@@ -382,8 +377,7 @@
 
   <para>We highlighted and attended a number of relevant DebConf
    talks, workshops and BOFs (informal <quote>Birds-of-a-Feather</quote>
-   workshops for individuals with common interests). Please see
-   <xref linkend="calendar"/> for the full schedule details.</para>
+   workshops for individuals with common interests).</para>
 
   <para>Most of the week consisted of less structured planning and
    hacking sessions several times a day. These centered around

Modified: trunk/docs/report/report-docbook/report-master.xml
==============================================================================
--- trunk/docs/report/report-docbook/report-master.xml	(original)
+++ trunk/docs/report/report-docbook/report-master.xml	Mon Oct  4 22:41:15 2004
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding='UTF-8'?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-  "docbookx.dtd"
+  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
  [ 
   <!ENTITY intro SYSTEM "intro.xml">
   <!ENTITY accomplishments SYSTEM "accomplishments.xml">
-  <!ENTITY socialspec SYSTEM "socialspec.xml">
+  <!ENTITY socialspec SYSTEM "social_spec.xml">
   <!ENTITY future SYSTEM "future.xml">
   <!ENTITY calendar SYSTEM "calendar.xml">
-  <!ENTITY finalpersonas SYSTEM "final_personas.xml">
+  <!ENTITY finalpersonas SYSTEM "final-personas.xml">
   <!ENTITY appdevelenv SYSTEM "appendix-development_environment.xml">
   <!ENTITY appcdd SYSTEM "appendix-cdd.xml">
   <!ENTITY appinstaller SYSTEM "appendix-installer.xml">
@@ -17,7 +17,7 @@
 <article>
 
  <articleinfo>
-  <title>Debian-NP Bagunça</title>
+  <title>Debian-NP BagunÃ§a</title>
   <subtitle>Report on Debian-NP's meeting at Debconf4</subtitle>
 
   <address>Porto Alegre, Brazil</address>
@@ -54,13 +54,21 @@
  </articleinfo>
 
 &intro;
+
 &accomplishments;
-&socialspecs;
+
+&socialspec;
+
 &future;
+
 &calendar;
+
 &finalpersonas;
+
 &appdevelenv;
+
 &appcdd;
+
 &appinstaller;
 
 

Modified: trunk/docs/report/report-docbook/social_spec.xml
==============================================================================
--- trunk/docs/report/report-docbook/social_spec.xml	(original)
+++ trunk/docs/report/report-docbook/social_spec.xml	Mon Oct  4 22:41:15 2004
@@ -1,6 +1,3 @@
-<?xml version="1.0" encoding='UTF-8'?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd">
-
 <sect1>
   <title>Social Specification</title>
   


