|
|
| (14 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| #[[CMakeUserUseLATEX| Back]]
| | {{CMake/Template/Moved}} |
|
| |
|
| -----
| | This page has moved [https://gitlab.kitware.com/cmake/community/wikis/contrib/modules/UseLATEX here]. |
| | |
| <pre>
| |
| #
| |
| # File: UseLATEX.cmake
| |
| # CMAKE commands to actually use the LaTeX compiler
| |
| # Version: 0.4
| |
| # Author: Kenneth Moreland (kmorel at sandia dot gov)
| |
| #
| |
| # Copyright 2004 Sandia Corporation.
| |
| # Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive
| |
| # license for use of this work by or on behalf of the
| |
| # U.S. Government. Redistribution and use in source and binary forms, with
| |
| # or without modification, are permitted provided that this Notice and any
| |
| # statement of authorship are reproduced on all copies.
| |
| #
| |
| # The following MACROS are defined:
| |
| #
| |
| # ADD_LATEX_IMAGES(<dir>)
| |
| # Searches <dir> for images files and creates targets that convert
| |
| # them to types that various LaTeX compilers understand. Makes the
| |
| # targets latex_images_ps and latex_images_pdf.
| |
| #
| |
| # ADD_LATEX_DOCUMENT(<name> <image_dir> <bib_file>)
| |
| # Adds targets that compile the <name>.tex files. It is assumed that
| |
| # ADD_LATEX_IMAGES has been called in <image_dir>. (Note that the
| |
| # dir parameter is different for the two commands.) <bib_file> is
| |
| # the bibliography file that is also copied to the output directory.
| |
| # CONFIGURE_FILE (with @ONLY flag) is also run on the tex file. Also
| |
| # copies any .cls .bst .clo files from the source directory to the
| |
| # binary directory. The following targets are made:
| |
| # dvi: Makes <name>.dvi
| |
| # pdf: Makes <name>.pdf using pdflatex.
| |
| # safepdf: Makes <name>.pdf using ps2pdf. If using the default
| |
| # program arguments, this will ensure all fonts are
| |
| # embedded and no lossy compression has been performed
| |
| # on images.
| |
| # ps: Makes <name>.ps
| |
| # html: Makes <name>.html
| |
| # auxclean: Deletes <name>.aux. This is sometimes necessary
| |
| # if a LaTeX error occurs and writes a bad aux file.
| |
| # If the variable LATEX_USE_INDEX is set to a true value, then
| |
| # commands to build an index are made.
| |
| #
| |
| # ADD_LATEX_TARGETS(<name> <image_dir> <bib_file>)
| |
| # Like ADD_LATEX_DOCUMENT, except no files are configured or copied.
| |
| # The files are assumed to already be added to the binary directory.
| |
| # This varient is helpful if one set of latex files makes different
| |
| # varients of documents. For example, with building chapters
| |
| # separately from the entire document.
| |
| | |
| IF ("${CMAKE_CURRENT_BINARY_DIR}" STREQUAL "${CMAKE_CURRENT_SOURCE_DIR}")
| |
| MESSAGE(SEND_ERROR "LaTeX files must be built out of source.")
| |
| ENDIF ("${CMAKE_CURRENT_BINARY_DIR}" STREQUAL "${CMAKE_CURRENT_SOURCE_DIR}")
| |
| | |
| INCLUDE(${CMAKE_ROOT}/Modules/FindLATEX.cmake)
| |
| MARK_AS_ADVANCED(CLEAR
| |
| LATEX_COMPILER
| |
| PDFLATEX_COMPILER
| |
| BIBTEX_COMPILER
| |
| MAKEINDEX_COMPILER
| |
| DVIPS_CONVERTER
| |
| PS2PDF_CONVERTER
| |
| LATEX2HTML_CONVERTER
| |
| )
| |
| | |
| MACRO(LATEX_NEEDIT VAR NAME)
| |
| IF (NOT ${VAR})
| |
| MESSAGE(SEND_ERROR "I need the ${NAME} command.")
| |
| ENDIF(NOT ${VAR})
| |
| ENDMACRO(LATEX_NEEDIT)
| |
| MACRO(LATEX_WANTIT VAR NAME)
| |
| IF (NOT ${VAR})
| |
| MESSAGE(STATUS "I could not find the ${NAME} command.")
| |
| ENDIF(NOT ${VAR})
| |
| ENDMACRO(LATEX_WANTIT)
| |
| | |
| LATEX_NEEDIT(LATEX_COMPILER latex)
| |
| LATEX_WANTIT(PDFLATEX_COMPILER pdflatex)
| |
| LATEX_NEEDIT(BIBTEX_COMPILER bibtex)
| |
| LATEX_NEEDIT(MAKEINDEX_COMPILER makeindex)
| |
| LATEX_WANTIT(DVIPS_CONVERTER dvips)
| |
| LATEX_WANTIT(PS2PDF_CONVERTER ps2pdf)
| |
| LATEX_WANTIT(LATEX2HTML_CONVERTER latex2html)
| |
| | |
| SET(LATEX_COMPILER_FLAGS "-interaction=nonstopmode"
| |
| CACHE STRING "Flags passed to latex.")
| |
| SET(PDFLATEX_COMPILER_FLAGS ${LATEX_COMPILER_FLAGS}
| |
| CACHE STRING "Flags passed to pdflatex.")
| |
| SET(BIBTEX_COMPILER_FLAGS ""
| |
| CACHE STRING "Flags passed to bibtex.")
| |
| SET(MAKEINDEX_COMPILER_FLAGS ""
| |
| CACHE STRING "Flags passed to makeindex.")
| |
| SET(DVIPS_CONVERTER_FLAGS "-Ppdf -G0 -t letter"
| |
| CACHE STRING "Flags passed to dvips.")
| |
| SET(PS2PDF_CONVERTER_FLAGS "-dMaxSubsetPct=100 -dCompatibilityLevel=1.3 -dSubsetFonts=true -dEmbedAllFonts=true -dAutoFilterColorImages=false -dAutoFilterGrayImages=false -dColorImageFilter=/FlateEncode -dGrayImageFilter=/FlateEncode -dMonoImageFilter=/FlateEncode"
| |
| CACHE STRING "Flags passed to ps2pdf.")
| |
| SET(LATEX2HTML_CONVERTER_FLAGS ""
| |
| CACHE STRING "Flags passed to latex2html.")
| |
| MARK_AS_ADVANCED(
| |
| LATEX_COMPILER_FLAGS
| |
| PDFLATEX_COMPILER_FLAGS
| |
| BIBTEX_COMPILER_FLAGS
| |
| MAKEINDEX_COMPILER_FLAGS
| |
| DVIPS_CONVERTER_FLAGS
| |
| PS2PDF_CONVERTER_FLAGS
| |
| LATEX2HTML_CONVERTER_FLAGS
| |
| )
| |
| SEPARATE_ARGUMENTS(LATEX_COMPILER_FLAGS)
| |
| SEPARATE_ARGUMENTS(PDFLATEX_COMPILER_FLAGS)
| |
| SEPARATE_ARGUMENTS(BIBTEX_COMPILER_FLAGS)
| |
| SEPARATE_ARGUMENTS(MAKEINDEX_COMPILER_FLAGS)
| |
| SEPARATE_ARGUMENTS(DVIPS_CONVERTER_FLAGS)
| |
| SEPARATE_ARGUMENTS(PS2PDF_CONVERTER_FLAGS)
| |
| SEPARATE_ARGUMENTS(LATEX2HTML_CONVERTER_FLAGS)
| |
| | |
| FIND_PROGRAM(IMAGEMAGICK_CONVERT convert
| |
| DOC "The convert program that comes with ImageMagick (available at http://www.imagemagick.org)."
| |
| )
| |
| IF (NOT IMAGEMAGICK_CONVERT)
| |
| MESSAGE(SEND_ERROR "Could not find convert program. Please download ImageMagick from http://www.imagemagick.org and install.")
| |
| ENDIF (NOT IMAGEMAGICK_CONVERT)
| |
| | |
| OPTION(LATEX_SMALL_IMAGES
| |
| "If on, the raster images will be converted to 1/6 the original size. This is because papers usually require 600 dpi images whereas most monitors only require at most 96 dpi. Thus, smaller images make smaller files for web distributation and can make it faster to read dvi files."
| |
| OFF)
| |
| IF (LATEX_SMALL_IMAGES)
| |
| SET(LATEX_RASTER_SCALE 16)
| |
| SET(LATEX_OPPOSITE_RASTER_SCALE 100)
| |
| ELSE (LATEX_SMALL_IMAGES)
| |
| SET(LATEX_RASTER_SCALE 100)
| |
| SET(LATEX_OPPOSITE_RASTER_SCALE 16)
| |
| ENDIF (LATEX_SMALL_IMAGES)
| |
| | |
| MACRO(ADD_LATEX_IMAGES dir)
| |
| FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/${dir})
| |
| | |
| # This command just makes sure we rebuild images of LATEX_SMALL_IMAGES
| |
| # changed.
| |
| ADD_CUSTOM_COMMAND(OUTPUT raster_image_rescale_${LATEX_RASTER_SCALE}
| |
| COMMAND ${CMAKE_COMMAND}
| |
| ARGS -E remove raster_image_rescale_${LATEX_OPPOSITE_RASTER_SCALE} \; ${CMAKE_COMMAND} -E echo Built > raster_image_rescale_${LATEX_RASTER_SCALE}
| |
| )
| |
| | |
| FILE(GLOB png_file_list ${CMAKE_CURRENT_SOURCE_DIR}/${dir}/*.png)
| |
| FOREACH (png_file ${png_file_list})
| |
| STRING(REGEX MATCH [^/]*$ png_out_file ${png_file})
| |
| SET(png_out_file ${CMAKE_CURRENT_BINARY_DIR}/${dir}/${png_out_file})
| |
| ADD_CUSTOM_COMMAND(OUTPUT ${png_out_file}
| |
| COMMAND ${IMAGEMAGICK_CONVERT}
| |
| ARGS ${png_file} -resize ${LATEX_RASTER_SCALE}% ${png_out_file}
| |
| DEPENDS ${png_file} raster_image_rescale_${LATEX_RASTER_SCALE}
| |
| COMMENT "png image"
| |
| )
| |
| SET(OUT_PNG_FILES ${OUT_PNG_FILES} ${png_out_file})
| |
| STRING(REGEX REPLACE [.]png$ .eps eps_file ${png_file})
| |
| STRING(REGEX MATCH [^/]*$ eps_file ${eps_file})
| |
| SET(eps_file ${CMAKE_CURRENT_BINARY_DIR}/${dir}/${eps_file})
| |
| ADD_CUSTOM_COMMAND(OUTPUT ${eps_file}
| |
| COMMAND ${IMAGEMAGICK_CONVERT}
| |
| ARGS ${png_file} -resize ${LATEX_RASTER_SCALE}% ${eps_file}
| |
| DEPENDS ${png_file} raster_image_rescale_${LATEX_RASTER_SCALE}
| |
| COMMENT "postscript image"
| |
| )
| |
| SET(OUT_EPS_FILES ${OUT_EPS_FILES} ${eps_file})
| |
| ENDFOREACH (png_file)
| |
| | |
| FILE(GLOB eps_file_list ${CMAKE_CURRENT_SOURCE_DIR}/${dir}/*.eps)
| |
| FOREACH (eps_file ${eps_file_list})
| |
| STRING(REGEX REPLACE [.]eps$ .pdf pdf_file ${eps_file})
| |
| STRING(REGEX MATCH [^/]*$ pdf_file ${pdf_file})
| |
| SET(pdf_file ${CMAKE_CURRENT_BINARY_DIR}/${dir}/${pdf_file})
| |
| ADD_CUSTOM_COMMAND(OUTPUT ${pdf_file}
| |
| COMMAND ${IMAGEMAGICK_CONVERT}
| |
| ARGS ${eps_file} ${pdf_file}
| |
| DEPENDS ${eps_file}
| |
| COMMENT "pdf image"
| |
| )
| |
| SET(OUT_PDF_FILES ${OUT_PDF_FILES} ${pdf_file})
| |
| STRING(REGEX MATCH [^/]*$ eps_out_file ${eps_file})
| |
| SET(eps_out_file ${CMAKE_CURRENT_BINARY_DIR}/${dir}/${eps_out_file})
| |
| ADD_CUSTOM_COMMAND(OUTPUT ${eps_out_file}
| |
| COMMAND ${CMAKE_COMMAND}
| |
| ARGS -E copy ${eps_file} ${eps_out_file}
| |
| DEPENDS ${eps_file}
| |
| COMMENT "postscript image"
| |
| )
| |
| SET(OUT_EPS_FILES ${OUT_EPS_FILES} ${eps_out_file})
| |
| ENDFOREACH (eps_file)
| |
| | |
| ADD_CUSTOM_TARGET(latex_images_ps
| |
| ${CMAKE_COMMAND} -E echo "Building image files for ps documents."
| |
| DEPENDS ${OUT_EPS_FILES}
| |
| )
| |
| ADD_CUSTOM_TARGET(latex_images_pdf
| |
| DEPENDS ${OUT_PNG_FILES} ${OUT_PDF_FILES})
| |
| ENDMACRO(ADD_LATEX_IMAGES)
| |
| | |
| | |
| MACRO(LATEX_COPY_GLOBBED_FILES pattern dest)
| |
| FILE(GLOB file_list ${pattern})
| |
| FOREACH(in_file ${file_list})
| |
| STRING(REGEX MATCH [^/]*$ out_file ${in_file})
| |
| CONFIGURE_FILE(${in_file} ${dest}/${out_file} COPYONLY)
| |
| ENDFOREACH(in_file)
| |
| ENDMACRO(LATEX_COPY_GLOBBED_FILES)
| |
| | |
| MACRO(ADD_LATEX_TARGETS name image_dir bib_file)
| |
| STRING(REGEX REPLACE [.]tex$ "" target ${name})
| |
| | |
| IF (${image_dir} STREQUAL NONE)
| |
| # No image directory. Fake image targets.
| |
| ADD_CUSTOM_TARGET(latex_images_ps)
| |
| ADD_CUSTOM_TARGET(latex_images_pdf)
| |
| ELSE (${image_dir} STREQUAL NONE)
| |
| IF (${image_dir} MATCHES ^[.]?$)
| |
| # Do not need to do anything, targets should already be made.
| |
| ELSE (${image_dir} MATCHES ^[.]?$)
| |
| ADD_CUSTOM_TARGET(latex_images_ps
| |
| ${CMAKE_COMMAND} -E chdir ${image_dir} ${CMAKE_MAKE_PROGRAM} latex_images_ps)
| |
| ADD_CUSTOM_TARGET(latex_images_pdf
| |
| ${CMAKE_COMMAND} -E chdir ${image_dir} ${CMAKE_MAKE_PROGRAM} latex_images_pdf)
| |
| ENDIF (${image_dir} MATCHES ^[.]?$)
| |
| ENDIF (${image_dir} STREQUAL NONE)
| |
| | |
| SET(make_dvi_command ${LATEX_COMPILER} ${LATEX_COMPILER_FLAGS} ${target}.tex)
| |
| SET(make_dvi_depends ${target}.tex latex_images_ps)
| |
| | |
| IF (${bib_file} STREQUAL NONE)
| |
| # No bibliography file.
| |
| SET(bibtarget ${target}.aux)
| |
| ELSE (${bib_file} STREQUAL NONE)
| |
| SET(make_dvi_command ${make_dvi_command}
| |
| COMMAND ${BIBTEX_COMPILER} ${BIBTEX_COMPILER_FLAGS} ${target})
| |
| SET(make_dvi_depends ${make_dvi_depends} ${target}.bib)
| |
| ENDIF (${bib_file} STREQUAL NONE)
| |
| | |
| IF (LATEX_USE_INDEX)
| |
| SET(make_dvi_command ${make_dvi_command}
| |
| COMMAND ${LATEX_COMPILER} ${LATEX_COMPILER_FLAGS} ${target}.tex
| |
| COMMAND ${MAKEINDEX_COMPILER} ${MAKEINDEX_COMPILER_FLAGS} ${target}.idx)
| |
| ENDIF (LATEX_USE_INDEX)
| |
| | |
| SET(make_dvi_command ${make_dvi_command}
| |
| COMMAND ${LATEX_COMPILER} ${LATEX_COMPILER_FLAGS} ${target}.tex
| |
| COMMAND ${LATEX_COMPILER} ${LATEX_COMPILER_FLAGS} ${target}.tex)
| |
| | |
| ADD_CUSTOM_TARGET(dvi ALL
| |
| ${make_dvi_command}
| |
| )
| |
| ADD_DEPENDENCIES(dvi ${make_dvi_depends})
| |
| | |
| IF (PDFLATEX_COMPILER)
| |
| ADD_CUSTOM_TARGET(pdf
| |
| ${PDFLATEX_COMPILER} ${PDFLATEX_COMPILER_FLAGS} ${target}.tex
| |
| )
| |
| ADD_DEPENDENCIES(pdf dvi latex_images_pdf)
| |
| ENDIF (PDFLATEX_COMPILER)
| |
| | |
| IF (DVIPS_CONVERTER)
| |
| ADD_CUSTOM_TARGET(ps
| |
| ${DVIPS_CONVERTER} ${DVIPS_CONVERTER_FLAGS} -o ${target}.ps ${target}.dvi
| |
| )
| |
| ADD_DEPENDENCIES(ps dvi)
| |
| IF (PS2PDF_CONVERTER)
| |
| ADD_CUSTOM_TARGET(safepdf
| |
| ${PS2PDF_CONVERTER} ${PS2PDF_CONVERTER_FLAGS} ${target}.ps ${target}.pdf
| |
| )
| |
| ADD_DEPENDENCIES(safepdf ps)
| |
| ENDIF (PS2PDF_CONVERTER)
| |
| ENDIF (DVIPS_CONVERTER)
| |
| | |
| IF (LATEX2HTML_CONVERTER)
| |
| ADD_CUSTOM_TARGET(html
| |
| ${LATEX2HTML_CONVERTER} ${LATEX2HTML_CONVERTER_FLAGS} ${target}.tex
| |
| )
| |
| ADD_DEPENDENCIES(html ${target}.tex)
| |
| ENDIF (LATEX2HTML_CONVERTER)
| |
| | |
| ADD_CUSTOM_TARGET(auxclean
| |
| ${CMAKE_COMMAND} -E remove ${target}.aux ${target}.idx ${target}.ind
| |
| )
| |
| ENDMACRO(ADD_LATEX_TARGETS)
| |
| | |
| MACRO(ADD_LATEX_DOCUMENT name image_dir bib_file)
| |
| STRING(REGEX REPLACE [.]tex$ "" target ${name})
| |
| | |
| CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/${target}.tex
| |
| ${target}.tex
| |
| @ONLY)
| |
| IF (${bib_file} STREQUAL NONE)
| |
| # No bibliography file.
| |
| ELSE (${bib_file} STREQUAL NONE)
| |
| CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/${bib_file}
| |
| ${bib_file}
| |
| COPYONLY)
| |
| ADD_CUSTOM_TARGET(${bib_file}
| |
| ${CMAKE_COMMAND} .
| |
| DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${bib_file}
| |
| )
| |
| ENDIF (${bib_file} STREQUAL NONE)
| |
| ADD_CUSTOM_TARGET(${target}.tex
| |
| ${CMAKE_COMMAND} .
| |
| DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${target}.tex
| |
| )
| |
| | |
| LATEX_COPY_GLOBBED_FILES(${CMAKE_CURRENT_SOURCE_DIR}/*.cls .)
| |
| LATEX_COPY_GLOBBED_FILES(${CMAKE_CURRENT_SOURCE_DIR}/*.bst .)
| |
| LATEX_COPY_GLOBBED_FILES(${CMAKE_CURRENT_SOURCE_DIR}/*.clo .)
| |
| | |
| ADD_LATEX_TARGETS(${name} ${image_dir} ${bib_file})
| |
| ENDMACRO(ADD_LATEX_DOCUMENT)
| |
| </pre>
| |
| | |
| -----
| |
| | |
| #[[CMakeUserUseLATEX| Back]]
| |
