docs build to break. Only images that are actually used are copied.
PNMTOPS = @PNMTOPS@
HTML2TEXT = @HTML2TEXT@
PLUCKERBUILD = @PLUCKERBUILD@
+COPY_IMAGES = ./scripts/copy-images.sh
THUMBPDF = @THUMBPDF@
PDFLATEX = TEXINPUTS=xslt/latex:.: @PDFLATEX@ --file-line-error-style
LATEX = TEXINPUTS=xslt/latex:.: @LATEX@ --file-line-error-style
LATEX_FIGURES = xslt/figures/caution.pdf xslt/figures/important.pdf xslt/figures/note.pdf xslt/figures/tip.pdf xslt/figures/warning.pdf
MANPAGES_PLUCKER = $(patsubst $(MANPAGEDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MANPAGES_SOURCES))
-Samba_HOWTO_Collection_IMAGES_PNG = $(wildcard Samba-HOWTO-Collection/imagefiles/*.png)
-Samba_Guide_IMAGES_PNG = $(wildcard Samba-Guide/images/*.png)
-
-Samba_HOWTO_Collection_IMAGEDIR = Samba-HOWTO-Collection/imagefiles
-Samba_Guide_IMAGEDIR = Samba-Guide/images
-
-Samba_HOWTO_Collection_IMAGES_EPS = $(patsubst %.png,%.eps,$(Samba_HOWTO_Collection_IMAGES_PNG))
-Samba_Guide_IMAGES_EPS = $(patsubst %.png,%.eps,$(Samba_Guide_IMAGES_PNG))
-
help:
@echo "Supported make targets:"
@echo " release - Build the docs needed for a Samba release"
$(DOCBOOKDIR)/%.xml: %/index.xml xslt/expand-sambadoc.xsl
mkdir -p $(@D)
- $(XSLTPROC) --stringparam noreference 1 --stringparam imagedir "$($(subst -,_,$*)_IMAGEDIR)/" --xinclude --output $@ xslt/expand-sambadoc.xsl $<
+ $(XSLTPROC) --stringparam latex.imagebasedir "$*/" --stringparam noreference 1 --xinclude --output $@ xslt/expand-sambadoc.xsl $<
$(DOCBOOKDIR)/%.xml: $(MANPAGEDIR)/%.xml xslt/expand-sambadoc.xsl
mkdir -p $(@D)
- $(XSLTPROC) --stringparam noreference 1 --output $@ xslt/expand-sambadoc.xsl $<
+ $(XSLTPROC) --stringparam latex.imagebasedir "$*/" --stringparam noreference 1 --output $@ xslt/expand-sambadoc.xsl $<
$(DOCBOOKDIR)/manpages.xml: $(MANPAGES_SOURCES) xslt/manpage-summary.xsl
mkdir -p $(@D)
$(HTMLDIR)/%/index.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/%/samba.css xslt/html-chunk.xsl
mkdir -p $(@D)
$(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/$*/" xslt/html-chunk.xsl $<
- -mkdir $(HTMLDIR)/$*/images
+ -mkdir $(@D)/images
+ $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $(@D)
# Single large HTML files
$(OUTPUTDIR)/%/samba.css: xslt/html/samba.css
mkdir -p $(@D)
cp $< $@
-$(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/samba.css $(patsubst %.png,$(HTMLDIR)/images/%.png,$(%_IMAGES_PNG)) xslt/html.xsl
- mkdir -p $(@D)
+$(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/samba.css xslt/html.xsl
+ mkdir -p $(@D)/images
+ $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $(@D)
$(XSLTPROC) --output $@ xslt/html.xsl $<
%-attributions.xml:
cp $< $@
# Adobe PDF files
-%.pdf: %.tex latexfigures gpl.tex $(%_IMAGES_PNG)
+%.pdf: %.tex latexfigures gpl.tex
-$(PDFLATEX) $<
-$(PDFLATEX) $<
$(MAKEINDEX) $*
mkdir -p $(@D)
cp $< $@
-%.dvi: %.tex %.idx gpl.tex $(%_IMAGES_EPS)
+%.dvi: %.tex %.idx gpl.tex
+ $(MAKE) $(shell $(XSLTPROC) --stringparam prepend "" --stringparam append ".eps" --stringparam role latex xslt/find-image-dependencies.xsl $(DOCBOOKDIR)/$*.xml)
-$(LATEX) $<
-$(LATEX) $<
$(MAKEINDEX) $*
mkdir -p $(@D)
$(XSLTPROC) --output $@ http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $<
-# HTML Help
-$(HTMLHELPDIR)/%/images/%.png: $(%_IMAGEDIR)/%.png
- mkdir -p $(@D)
- cp $< $@
-
-$(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml #$(patsubst $(%_IMAGEDIR)/%.png,$(HTMLHELPDIR)/%/images/%.png,$(%_IMAGEDIR)/*.png)
- -mkdir $@
+$(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml
+ -mkdir -p $@/images
+ $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $@
$(XSLTPROC) --stringparam htmlhelp.chm $*.chm --stringparam manifest.in.base.dir "$@/" --stringparam base.dir "$@/" http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl $<
# Plucker docs
</para>
<image id="pktcap01">
- <imagefile scale="53">WINREPRESSME-Capture.png</imagefile>
- <description>Windows Me &smbmdash; Broadcasts &smbmdash; The First 10 Minutes</description>
+ <imagefile scale="53">WINREPRESSME-Capture</imagefile>
+ <imagedescription>Windows Me &smbmdash; Broadcasts &smbmdash; The First 10 Minutes</imagedescription>
</image>
<image id="pktcap02">
- <description>Windows Me &smbmdash; Later Broadcast Sample</description>
- <imagefile scale="57">WINREPRESSME-Capture2.png</imagefile>
+ <imagedescription>Windows Me &smbmdash; Later Broadcast Sample</imagedescription>
+ <imagefile scale="57">WINREPRESSME-Capture2</imagefile>
</image>
<para><indexterm>
</sect3>
<image id="hostannounce">
- <description>Typical Windows 9x/Me Host Announcement</description>
- <imagefile scale="55">HostAnnouncment.png</imagefile>
+ <imagedescription>Typical Windows 9x/Me Host Announcement</imagedescription>
+ <imagefile scale="55">HostAnnouncment</imagefile>
</image>
</sect2>
</para>
<image id="nullconnect">
- <description>Typical Windows 9x/Me NULL SessionSetUp AndX Request</description>
+ <imagedescription>Typical Windows 9x/Me NULL SessionSetUp AndX Request</imagedescription>
- <imagefile scale="65">NullConnect.png</imagefile>
+ <imagefile scale="65">NullConnect</imagefile>
</image>
<para>
</para>
<image id="userconnect">
- <description>Typical Windows 9x/Me User SessionSetUp AndX Request</description>
- <imagefile scale="65">UserConnect.png</imagefile>
+ <imagedescription>Typical Windows 9x/Me User SessionSetUp AndX Request</imagedescription>
+ <imagefile scale="65">UserConnect</imagefile>
</image>
<para>
</procedure>
<image id="XPCap01">
- <description>Typical Windows XP NULL Session Setup AndX Request</description>
- <imagefile scale="70">WindowsXP-NullConnection.png</imagefile>
+ <imagedescription>Typical Windows XP NULL Session Setup AndX Request</imagedescription>
+ <imagefile scale="70">WindowsXP-NullConnection</imagefile>
</image>
<image id="XPCap02">
- <description>Typical Windows XP User Session Setup AndX Request</description>
- <imagefile scale="70">WindowsXP-UserConnection.png</imagefile>
+ <imagedescription>Typical Windows XP User Session Setup AndX Request</imagedescription>
+ <imagefile scale="70">WindowsXP-UserConnection</imagefile>
</image>
<sect3>
</para>
<image id="charitynet">
- <description>Charity Administration Office Network</description>
- <imagefile scale="100">Charity-Network.png</imagefile>
+ <imagedescription>Charity Administration Office Network</imagedescription>
+ <imagefile scale="100">Charity-Network</imagefile>
</image>
<procedure>
</para>
<image id="acctingnet2">
- <description>Accounting Office Network Topology</description>
- <imagefile scale="100">AccountingNetwork.png</imagefile>
+ <imagedescription>Accounting Office Network Topology</imagedescription>
+ <imagefile scale="100">AccountingNetwork</imagefile>
</image>
<table id="acctingnet">
</para>
<image id="acct2net">
- <description>Abmas Accounting &smbmdash; 52 User Network Topology</description>
- <imagefile scale="100">acct2net.png</imagefile>
+ <imagedescription>Abmas Accounting &smbmdash; 52 User Network Topology</imagedescription>
+ <imagefile scale="100">acct2net</imagefile>
</image>
<procedure>
</table>
<image id="ch04net">
- <description>Abmas Network Topology &smbmdash; 130 Users</description>
- <imagefile scale="90">chap4-net.png</imagefile>
+ <imagedescription>Abmas Network Topology &smbmdash; 130 Users</imagedescription>
+ <imagefile scale="90">chap4-net</imagefile>
</image>
<para>
</para>
<image id="chap05net">
- <description>Network Topology &smbmdash; 500 User Network Using tdbsam passdb backend.</description>
- <imagefile scale="80">chap5-net.png</imagefile>
+ <imagedescription>Network Topology &smbmdash; 500 User Network Using tdbsam passdb backend.</imagedescription>
+ <imagefile scale="80">chap5-net</imagefile>
</image>
<sect2 id="ch5-dnshcp-setup">
</para>
<image id="ch6-LDAPdiag">
- <description>The Interaction of LDAP, UNIX Posix Accounts and Samba Accounts</description>
- <imagefile scale="70">UNIX-Samba-and-LDAP.png</imagefile>
+ <imagedescription>The Interaction of LDAP, UNIX Posix Accounts and Samba Accounts</imagedescription>
+ <imagefile scale="70">UNIX-Samba-and-LDAP</imagefile>
</image>
<para><indexterm>
</para>
<image id="chap6net">
- <description>Network Topology &smbmdash; 500 User Network Using ldapsam passdb backend.</description>
- <imagefile scale="70">chap6-net.png</imagefile>
+ <imagedescription>Network Topology &smbmdash; 500 User Network Using ldapsam passdb backend.</imagedescription>
+ <imagefile scale="70">chap6-net</imagefile>
</image>
<para><indexterm>
</procedure>
<image id="XP-screen001">
- <description>Windows XP Professional &smbmdash; User Shared Folders</description>
- <imagefile scale="65">XP-screen001.png</imagefile>
+ <imagedescription>Windows XP Professional &smbmdash; User Shared Folders</imagedescription>
+ <imagefile scale="65">XP-screen001</imagefile>
</image>
<table id="proffold">
inconsistent directory information can be exceedingly difficult.</para>
<image id="chap7net">
- <description>Network Topology &smbmdash; 2000 User Complex Design A</description>
- <imagefile scale="80">chap7-net-Ar.png</imagefile>
+ <imagedescription>Network Topology &smbmdash; 2000 User Complex Design A</imagedescription>
+ <imagefile scale="80">chap7-net-Ar</imagefile>
</image>
<image id="chap7net2">
- <description>Network Topology &smbmdash; 2000 User Complex Design B</description>
- <imagefile scale="80">chap7-net2-Br.png</imagefile>
+ <imagedescription>Network Topology &smbmdash; 2000 User Complex Design B</imagedescription>
+ <imagefile scale="80">chap7-net2-Br</imagefile>
</image>
</sect3>
</para>
<image id="chap7idres">
- <description>Samba and Authentication Backend Search Pathways</description>
- <imagefile scale="80">chap7-idresol.png</imagefile>
+ <imagedescription>Samba and Authentication Backend Search Pathways</imagedescription>
+ <imagefile scale="80">chap7-idresol</imagefile>
</image>
<para><indexterm>
This configuration tells Samba to use a single LDAP server as shown in
<link linkend="ch7singleLDAP"/>.
<image id="ch7singleLDAP">
- <description>Samba Configuration to Use a Single LDAP Server</description>
- <imagefile scale="100">ch7-singleLDAP.png</imagefile>
+ <imagedescription>Samba Configuration to Use a Single LDAP Server</imagedescription>
+ <imagefile scale="100">ch7-singleLDAP</imagefile>
</image>
<indexterm>
<primary>LDAP</primary>
This configuration tells Samba to use a master LDAP server, with fail-over to a slave server if necessary,
as shown in <link linkend="ch7dualLDAP"/>.
<image id="ch7dualLDAP">
- <description>Samba Configuration to Use a Dual (Fail-over) LDAP Server</description>
- <imagefile scale="100">ch7-fail-overLDAP.png</imagefile>
+ <imagedescription>Samba Configuration to Use a Dual (Fail-over) LDAP Server</imagedescription>
+ <imagefile scale="100">ch7-fail-overLDAP</imagefile>
</image>
</para>
</para>
<image id="ch7dualadd">
- <description>Samba Configuration to Use Dual LDAP Databases - Broken - Do Not Use!</description>
- <imagefile scale="80">ch7-dual-additive-LDAP.png</imagefile>
+ <imagedescription>Samba Configuration to Use Dual LDAP Databases - Broken - Do Not Use!</imagedescription>
+ <imagefile scale="80">ch7-dual-additive-LDAP</imagefile>
</image>
<para>
</para>
<image id="ch7dualok">
- <description>Samba Configuration to Use Two LDAP Databases - The result is additive.</description>
- <imagefile scale="80">ch7-dual-additive-LDAP-Ok.png</imagefile>
+ <imagedescription>Samba Configuration to Use Two LDAP Databases - The result is additive.</imagedescription>
+ <imagefile scale="80">ch7-dual-additive-LDAP-Ok</imagefile>
</image>
<note><para>
</para>
<image id="ch8-migration">
- <description>Schematic Explaining the <command>net rpc vampire</command> Process</description>
- <imagefile scale="80">ch8-migration.png</imagefile>
+ <imagedescription>Schematic Explaining the <command>net rpc vampire</command> Process</imagedescription>
+ <imagefile scale="80">ch8-migration</imagefile>
</image>
<para>
</para>
<image id="NT4DUM">
- <description>View of Accounts in NT4 Domain User Manager</description>
- <imagefile scale="50">UserMgrNT4.png</imagefile>
+ <imagedescription>View of Accounts in NT4 Domain User Manager</imagedescription>
+ <imagefile scale="50">UserMgrNT4</imagefile>
</image>
</sect2>
</para>
<image id="ch09openmag">
- <description>Open Magazine Samba Survey</description>
- <imagefile scale="60">openmag.png</imagefile>
+ <imagedescription>Open Magazine Samba Survey</imagedescription>
+ <imagefile scale="60">openmag</imagefile>
</image>
<para>
</para>
<image id="ch9-sambadc">
- <description>Samba Domain: Samba Member Server</description>
- <imagefile scale="75">chap9-SambaDC.png</imagefile>
+ <imagedescription>Samba Domain: Samba Member Server</imagedescription>
+ <imagefile scale="75">chap9-SambaDC</imagefile>
</image>
<para><indexterm>
</para>
<image id="ch9-adsdc">
- <description>Active Directory Domain: Samba Member Server</description>
- <imagefile scale="75">chap9-ADSDC.png</imagefile>
+ <imagedescription>Active Directory Domain: Samba Member Server</imagedescription>
+ <imagefile scale="75">chap9-ADSDC</imagefile>
</image>
<procedure>
</para>
<image id="lam-login">
- <description>The LDAP Account Manager Login Screen</description>
- <imagefile scale="50">lam-login.png</imagefile>
+ <imagedescription>The LDAP Account Manager Login Screen</imagedescription>
+ <imagefile scale="50">lam-login</imagefile>
</image>
<para><indexterm>
</para>
<image id="lam-config">
- <description>The LDAP Account Manager Configuration Screen</description>
- <imagefile scale="50">lam-config.png</imagefile>
+ <imagedescription>The LDAP Account Manager Configuration Screen</imagedescription>
+ <imagefile scale="50">lam-config</imagefile>
</image>
<para><indexterm>
</para>
<image id="lam-user">
- <description>The LDAP Account Manager User Edit Screen</description>
- <imagefile scale="50">lam-users.png</imagefile>
+ <imagedescription>The LDAP Account Manager User Edit Screen</imagedescription>
+ <imagefile scale="50">lam-users</imagefile>
</image>
<para>
</para>
<image id="lam-group">
- <description>The LDAP Account Manager Group Edit Screen</description>
- <imagefile scale="50">lam-groups.png</imagefile>
+ <imagedescription>The LDAP Account Manager Group Edit Screen</imagedescription>
+ <imagefile scale="50">lam-groups</imagefile>
</image>
<image id="lam-group-mem">
- <description>The LDAP Account Manager Group Membership Edit Screen</description>
- <imagefile scale="50">lam-group-members.png</imagefile>
+ <imagedescription>The LDAP Account Manager Group Membership Edit Screen</imagedescription>
+ <imagefile scale="50">lam-group-members</imagefile>
</image>
<para><indexterm>
</para>
<image id="lam-host">
- <description>The LDAP Account Manager Host Edit Screen</description>
- <imagefile scale="50">lam-hosts.png</imagefile>
+ <imagedescription>The LDAP Account Manager Host Edit Screen</imagedescription>
+ <imagefile scale="50">lam-hosts</imagefile>
</image>
<para>
parameters in the &smb.conf; file.
</para>
- <figure id="idmap-sid2gid"><title>IDMAP: group SID to GID resolution.</title>
- <mediaobject>
- <imageobject role="latex"><imagedata fileref="howto/imagefiles/idmap-sid2gid" scale="50" scalefit="1"/></imageobject>
- <imageobject><imagedata fileref="howto/imagefiles/idmap-sid2gid.png" scale="50" scalefit="1"/></imageobject>
- </mediaobject>
- </figure>
-
- <figure id="idmap-gid2sid"><title>IDMAP: GID resolution to matching SID.</title>
- <mediaobject>
- <imageobject role="latex"><imagedata fileref="howto/imagefiles/idmap-gid2sid" scale="50" scalefit="1"/></imageobject>
- <imageobject><imagedata fileref="howto/imagefiles/idmap-gid2sid.png" scale="50" scalefit="1"/></imageobject>
- </mediaobject>
- </figure>
+ <image id="idmap-sid2gid">
+ <description>IDMAP: group SID to GID resolution.</description>
+ <imagefile scale="50">idmap-sid2gid</imagefile>
+ </image>
+
+ <image id="idmap-gid2sid"><description>IDMAP: GID resolution to matching SID.</description>
+ <imagefile scale="50">idmap-gid2sid</imagefile>
+ </image>
<para>
In both cases, when winbindd is not running, only locally resolvable groups can be recognized. Please refer to
used to establish UNIX group to NT SID mappings as shown in <link linkend="idmap-store-gid2sid">IDMAP: storing group mappings</link>.
</para>
- <figure id="idmap-store-gid2sid"><title>IDMAP storing group mappings.</title>
- <mediaobject>
- <imageobject role="latex"><imagedata fileref="howto/imagefiles/idmap-store-gid2sid" scale="50" scalefit="1"/></imageobject>
- <imageobject><imagedata fileref="howto/imagefiles/idmap-store-gid2sid.png" scale="50" scalefit="1"/></imageobject>
- </mediaobject>
- </figure>
-
+ <image id="idmap-store-gid2sid"><description>IDMAP storing group mappings.</description>
+ <imagefile scale="50">idmap-store-gid2sid</imagefile>
+ </image>
<para>
<indexterm><primary>groupadd</primary></indexterm>
network clients.
</para>
-<figure id="domain-example"><title>An Example Domain.</title>
-<mediaobject>
-<imageobject role="latex"><imagedata fileref="howto/imagefiles/domain" width="4in" height="3in" scalefit="1"/></imageobject>
-<imageobject><imagedata fileref="howto/imagefiles/domain.png" scale="50" scalefit="1"/></imageobject>
-</mediaobject>
-</figure>
-
+<image id="domain-example"><description>An Example Domain.</description>
+<imagefile scale="50">domain</imagefile>
+</image>
<?latex \newpage ?>
</para></note>
- <!-- <figure id="winbind_idmap"><title></title>
- <mediaobject>
- <imageobject role="latex"><imagedata fileref="howto/imagefiles/idmap_winbind_no_loop" scale="50" scalefit="1"/></imageobject>
- <imageobject><imagedata fileref="howto/imagefiles/idmap_winbind_no_loop.png" scale="50" scalefit="1"/></imageobject>
- </mediaobject>
- </figure>-->
+ <image id="winbind_idmap">
+ <imagefile scale="50">idmap_winbind_no_loop</imagefile>
+ </image>
</sect1>
--- /dev/null
+#!/bin/sh
+ROLE="$1"
+XMLFILE="$2"
+FROM="$3"
+TO="$4"
+
+for x in `xsltproc --stringparam prepend "" --stringparam append "" --stringparam role "$ROLE" xslt/find-image-dependencies.xsl "$XMLFILE"`
+do
+ cp -u $FROM/$x $TO/$x || exit 1
+done
+exit
<xsl:attribute name="role"><xsl:text>latex</xsl:text></xsl:attribute>
<xsl:element name="imagedata">
<xsl:attribute name="fileref">
- <xsl:value-of select="$imagedir"/><xsl:value-of select="imagefile"/></xsl:attribute>
+ <xsl:value-of select="$latex.imagebasedir"/><xsl:text>images/</xsl:text><xsl:value-of select="imagefile"/></xsl:attribute>
<xsl:attribute name="scale">
<xsl:choose>
<xsl:when test="@scale != ''">
--- /dev/null
+<?xml version='1.0'?>
+<!--
+ Find the image dependencies of a certain XML file
+ (C) Jelmer Vernooij 2004
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.1">
+ <xsl:output method="text"/>
+
+ <xsl:template match="mediaobject/imageobject[@role=$role]">
+ <xsl:value-of select="$prepend"/>
+ <xsl:value-of select="imagedata/@fileref"/>
+ <xsl:value-of select="$append"/>
+ <xsl:text> </xsl:text>
+ </xsl:template>
+
+ <xsl:template match="text()"/>
+ <xsl:template match="*">
+ <xsl:apply-templates/>
+ </xsl:template>
+</xsl:stylesheet>