Changeset 6029a6 for doc/Makefile.am

Timestamp:

May 26, 2014, 9:15:08 AM (11 years ago)

Author:

Frederik Heber <heber@…>

Branches:

Action_Thermostats, Add_AtomRandomPerturbation, Add_FitFragmentPartialChargesAction, Add_RotateAroundBondAction, Add_SelectAtomByNameAction, Added_ParseSaveFragmentResults, AddingActions_SaveParseParticleParameters, Adding_Graph_to_ChangeBondActions, Adding_MD_integration_tests, Adding_ParticleName_to_Atom, Adding_StructOpt_integration_tests, AtomFragments, Automaking_mpqc_open, AutomationFragmentation_failures, Candidate_v1.5.4, Candidate_v1.6.0, Candidate_v1.6.1, ChangeBugEmailaddress, ChangingTestPorts, ChemicalSpaceEvaluator, CombiningParticlePotentialParsing, Combining_Subpackages, Debian_Package_split, Debian_package_split_molecuildergui_only, Disabling_MemDebug, Docu_Python_wait, EmpiricalPotential_contain_HomologyGraph, EmpiricalPotential_contain_HomologyGraph_documentation, Enable_parallel_make_install, Enhance_userguide, Enhanced_StructuralOptimization, Enhanced_StructuralOptimization_continued, Example_ManyWaysToTranslateAtom, Exclude_Hydrogens_annealWithBondGraph, FitPartialCharges_GlobalError, Fix_BoundInBox_CenterInBox_MoleculeActions, Fix_ChargeSampling_PBC, Fix_ChronosMutex, Fix_FitPartialCharges, Fix_FitPotential_needs_atomicnumbers, Fix_ForceAnnealing, Fix_IndependentFragmentGrids, Fix_ParseParticles, Fix_ParseParticles_split_forward_backward_Actions, Fix_PopActions, Fix_QtFragmentList_sorted_selection, Fix_Restrictedkeyset_FragmentMolecule, Fix_StatusMsg, Fix_StepWorldTime_single_argument, Fix_Verbose_Codepatterns, Fix_fitting_potentials, Fixes, ForceAnnealing_goodresults, ForceAnnealing_oldresults, ForceAnnealing_tocheck, ForceAnnealing_with_BondGraph, ForceAnnealing_with_BondGraph_continued, ForceAnnealing_with_BondGraph_continued_betteresults, ForceAnnealing_with_BondGraph_contraction-expansion, FragmentAction_writes_AtomFragments, FragmentMolecule_checks_bonddegrees, GeometryObjects, Gui_Fixes, Gui_displays_atomic_force_velocity, ImplicitCharges, IndependentFragmentGrids, IndependentFragmentGrids_IndividualZeroInstances, IndependentFragmentGrids_IntegrationTest, IndependentFragmentGrids_Sole_NN_Calculation, JobMarket_RobustOnKillsSegFaults, JobMarket_StableWorkerPool, JobMarket_unresolvable_hostname_fix, MoreRobust_FragmentAutomation, ODR_violation_mpqc_open, PartialCharges_OrthogonalSummation, PdbParser_setsAtomName, PythonUI_with_named_parameters, QtGui_reactivate_TimeChanged_changes, Recreated_GuiChecks, Rewrite_FitPartialCharges, RotateToPrincipalAxisSystem_UndoRedo, SaturateAtoms_findBestMatching, SaturateAtoms_singleDegree, StoppableMakroAction, Subpackage_CodePatterns, Subpackage_JobMarket, Subpackage_LinearAlgebra, Subpackage_levmar, Subpackage_mpqc_open, Subpackage_vmg, Switchable_LogView, ThirdParty_MPQC_rebuilt_buildsystem, TrajectoryDependenant_MaxOrder, TremoloParser_IncreasedPrecision, TremoloParser_MultipleTimesteps, TremoloParser_setsAtomName, Ubuntu_1604_changes, stable

Children:

7e3e41

Parents:

caece4

git-author:

Frederik Heber <heber@…> (04/13/14 12:48:51)

git-committer:

Frederik Heber <heber@…> (05/26/14 09:15:08)

Message:

Added largely extended userguide with some images into subfolder of doc folder.

• Munched docbook into something workable:
  • the big problem was out-of-source build in conjunction with the figures in the userguide.
  • I did not try hard enough with img.src.path but used entityref instead together with a catalog file.
  • so in all, we have followed:
    • ​http://movementarian.org/docs/docbook-autotools/index.html
    • ​http://www.sagehill.net/docbookxsl/GraphicsLocations.html
  • ... this was a long way ...
  • am_conditioning on both xsltproc and fop.

File:

• doc/Makefile.am (modified) (1 diff)

doc/Makefile.am

@@ -1 +1 @@
 EXTRA_DIST =
 
-include am_doxygen_include.am
+# userguide documentation
 
-EXTRA_DIST += am_doxygen_include.am Doxyfile
+EXTRA_DIST += \
+        userguide/createguide.sh \
+        $(top_builddir)/doc/molecuilder.pdf
+
+XSLTPROC=xsltproc
+XSLTPROC_FLAGS=@XSLTPROC_FLAGS@ \
+        --stringparam paper.type A4
+PDF_STYLESHEET=@DOCBOOK_ROOT@/fo/docbook.xsl
+XML_CATALOG_FILES=$(top_builddir)/doc/userguide/catalog.xml
+FOP=fop
+
+pdfdir = $(prefix)/share/doc/@PACKAGE@
+dist_pdf_DATA = @PACKAGE@.pdf
+
+if have_fop
+if have_xsltproc
+
+@PACKAGE@.fo: $(top_srcdir)/doc/userguide/userguide.xml
+        XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(PDF_STYLESHEET) $<
+@PACKAGE@.pdf: @PACKAGE@.fo
+        $(FOP) -fo $< -pdf $@
+
+else
+
+@PACKAGE@.pdf:
+        touch $@
+
+endif
+else
+
+@PACKAGE@.pdf:
+        touch $@
+
+endif
+
+clean-local:
+        $(RM) -f doc/userguide/catalog.xml
+        $(RM) -f @PACKAGE@.fo
+        $(RM) -f @PACKAGE@.pdf
+
+distclean-local:
+        $(RM) -f doc/userguide/catalog.xml
+        $(RM) -f @PACKAGE@.fo
+        $(RM) -f @PACKAGE@.pdf
+
+
+SUBDIRS = userguide
+
+EXTRA_DIST += \
+        am_doxygen_include.am \
+        Doxyfile
 
 include ../src/documentation/Makefile.am
 
-
+include am_doxygen_include.am