LaTeX
/
pdflatex.sh
mirror of https://github.com/mkalewski/pdflatex.sh.git
1
0
Fork 0
Code Issues Releases Wiki Activity

'SyncTex' synchronization (thanks to 'tdi' https://github.com/tdi) and handouts from beamer presentations added.

This commit is contained in:
Michal Kalewski 2011-10-19 15:57:45 +02:00
parent e70ea0f96e
commit 7d1315f60d
2 changed files with 88 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@ -8,7 +8,7 @@ NAME
SYNOPSIS SYNOPSIS
-------- --------
pdflatex.sh -h | -V pdflatex.sh -h | -V
pdflatex.sh [ +3 +b +i +o +p ] FILE(.tex) pdflatex.sh [ +3 +b +h +i +o +p +sync ] FILE(.tex)
pdflatex.sh -2x1 | -2x2 FILE(.pdf) pdflatex.sh -2x1 | -2x2 FILE(.pdf)
pdflatex.sh -gs | -rs | -gd | -rd DIR pdflatex.sh -gs | -rs | -gd | -rd DIR
pdflatex.sh -b | -c | -i | -k | -kk | -l [WIDTH] | -n | -s | -ss pdflatex.sh -b | -c | -i | -k | -kk | -l [WIDTH] | -n | -s | -ss
@ -45,6 +45,9 @@ OPTIONS
-gd DIR convert DIA images in directory DIR -gd DIR convert DIA images in directory DIR
-rd DIR convert DIA images in directory DIR recursively -rd DIR convert DIA images in directory DIR recursively
-h print (this) help message and exit -h print (this) help message and exit
+h make handout from beamer presentation, i.e. without
overlays, pauses, and other beamer effects (the output
will be in FILE-handout.pdf file)
+i make also index +i make also index
-i FILE make ONLY index -i FILE make ONLY index
-k FILE run 'chktex' command (if available) -k FILE run 'chktex' command (if available)
@ -55,6 +58,8 @@ OPTIONS
-ss FILE STRICTLY check sentence separators -ss FILE STRICTLY check sentence separators
-sc [LANG] FILE run interactive spell checker (by default LANG="en_GB" -sc [LANG] FILE run interactive spell checker (by default LANG="en_GB"
and UTF-8 encoding is used) and UTF-8 encoding is used)
+sync enable synchronization between source file and the
resulting DVI or PDF file (see also: [1])
+o open PDF (or DVI) file after compilation +o open PDF (or DVI) file after compilation
+p use 'ps4pdf' instead of 'pdflatex'/'latex' (PSTricks) +p use 'ps4pdf' instead of 'pdflatex'/'latex' (PSTricks)
-V print script version -V print script version
@ -74,6 +79,11 @@ EXAMPLES
> Compile `file.tex` with the use of PSTricks. > Compile `file.tex` with the use of PSTricks.
pdflatex.sh +h beamer-presentation.tex
> Compile and make handout from beamer presentation file (the output should be
> in `beamer-presentation-handout.pdf` file).
pdflatex.sh -kk file.tex pdflatex.sh -kk file.tex
> Run `chktex` command but show only errors. > Run `chktex` command but show only errors.
@ -107,3 +117,6 @@ COPYRIGHT
TERMS AND CONDITIONS OF THE MIT LICENSE. YOU SHOULD HAVE RECEIVED A COPY TERMS AND CONDITIONS OF THE MIT LICENSE. YOU SHOULD HAVE RECEIVED A COPY
OF THE LICENSE ALONG WITH THIS SOFTWARE; IF NOT, YOU CAN DOWNLOAD A COPY OF THE LICENSE ALONG WITH THIS SOFTWARE; IF NOT, YOU CAN DOWNLOAD A COPY
FROM HTTP://WWW.OPENSOURCE.ORG. FROM HTTP://WWW.OPENSOURCE.ORG.
[1]: [http://www.tug.org/TUGboat/tb29-3/tb93laurens.pdf](http://www.tug.org/TUGboat/tb29-3/tb93laurens.pdf) "Direct and reverse synchronization with SyncTEX"

97
pdflatex.sh
View File

@ -14,7 +14,7 @@
# #
# SYNOPSIS # SYNOPSIS
# pdflatex.sh -h | -V # pdflatex.sh -h | -V
# pdflatex.sh [ +3 +b +i +o +p ] FILE(.tex) # pdflatex.sh [ +3 +b +h +i +o +p +sync ] FILE(.tex)
# pdflatex.sh -2x1 | -2x2 FILE(.pdf) # pdflatex.sh -2x1 | -2x2 FILE(.pdf)
# pdflatex.sh -gs | -rs | -gd | -rd DIR # pdflatex.sh -gs | -rs | -gd | -rd DIR
# pdflatex.sh -b | -c | -i | -k | -kk | -l [WIDTH] | -n | -s | -ss # pdflatex.sh -b | -c | -i | -k | -kk | -l [WIDTH] | -n | -s | -ss
@ -34,7 +34,7 @@
# VERSION # VERSION
# ======= # =======
VERSION=3.0.0 VERSION=3.0.2
# PROGRAMS # PROGRAMS
@ -61,6 +61,7 @@ ASPELL_LANG_OPT="-l en_GB"
CHKTEX_OPT="-q -v1" CHKTEX_OPT="-q -v1"
LATEX_BATCHMODE_OPT="-interaction batchmode" LATEX_BATCHMODE_OPT="-interaction batchmode"
#LATEX_OUTPUT_DIRECTORY_OPT="-output-directory" #LATEX_OUTPUT_DIRECTORY_OPT="-output-directory"
PDFLATEX_SYNCTEX_OPT="-synctex=1"
PDFNUP_OPT="--paper a4paper --frame true --scale 0.96 --delta \"2mm 2mm\"" PDFNUP_OPT="--paper a4paper --frame true --scale 0.96 --delta \"2mm 2mm\""
PS4PDF_LATEX_OPT="\AtBeginDocument{\RequirePackage{pst-pdf}}" PS4PDF_LATEX_OPT="\AtBeginDocument{\RequirePackage{pst-pdf}}"
@ -76,11 +77,14 @@ OUTPUT_DIRECTORY=
# Extensions of auxiliary files: # Extensions of auxiliary files:
AUXILIARYEXTS=\ AUXILIARYEXTS=\
"aux idx ilg ind out toc lot lof loa nav snm vrb bbl blg svn" # " log dvi" "aux idx ilg ind out toc lot lof loa nav snm vrb bbl blg svn"
# + " log dvi synctex.gz"
AUXILIARYEXTS_BIBTEX=\ AUXILIARYEXTS_BIBTEX=\
"aux idx ilg ind out toc lot lof loa nav snm vrb blg svn dvi pdf" # " log bbl" "aux idx ilg ind out toc lot lof loa nav snm vrb blg svn dvi pdf synctex.gz"
# + " log bbl"
AUXILIARYEXTS_INDEX=\ AUXILIARYEXTS_INDEX=\
"aux ilg ind out toc lot lof loa nav snm vrb bbl blg svn dvi log pdf" # " idx" "aux ilg ind out toc lot lof loa nav snm vrb bbl blg svn dvi log pdf synctex.gz"
# + " idx"
# Base name of the script: # Base name of the script:
THENAME="$(basename $0)" THENAME="$(basename $0)"
@ -117,12 +121,15 @@ NOTE: If the script is run as 'pdflatex.sh' then 'pdflatex' command is used
output file). Thus if necessary, the 'latex.sh' symbolic link can be created output file). Thus if necessary, the 'latex.sh' symbolic link can be created
to use the script easily. to use the script easily.
${txtbld}For more information, please visit${txtrst}: \
<https://github.com/mkalewski/pdflatex.sh>
${txtbld}Usage${txtrst}: ${txtbld}Usage${txtrst}:
pdflatex.sh -h | -V pdflatex.sh -h | -V
Print help or version. Print help or version.
pdflatex.sh [ +3 +b +i +o +p ] FILE(.tex) pdflatex.sh [ +3 +b +h +i +o +p +sync ] FILE(.tex)
Compile TeX/LaTeX files. Compile (La)TeX files.
pdflatex.sh -2x1 | -2x2 FILE(.pdf) pdflatex.sh -2x1 | -2x2 FILE(.pdf)
PDF documents manipulation. PDF documents manipulation.
@ -148,6 +155,9 @@ ${txtbld}Options${txtrst}:
-gd DIR convert DIA images in directory DIR -gd DIR convert DIA images in directory DIR
-rd DIR convert DIA images in directory DIR recursively -rd DIR convert DIA images in directory DIR recursively
-h print (this) help message and exit -h print (this) help message and exit
+h make handout from beamer presentation, i.e. without
overlays, pauses, and other beamer effects (the output
will be in FILE-handout.pdf file)
+i make also index +i make also index
-i FILE make ONLY index -i FILE make ONLY index
-k FILE run 'chktex' command (if available) -k FILE run 'chktex' command (if available)
@ -158,6 +168,8 @@ ${txtbld}Options${txtrst}:
-ss FILE STRICTLY check sentence separators -ss FILE STRICTLY check sentence separators
-sc [LANG] FILE run interactive spell checker (by default LANG="en_GB" -sc [LANG] FILE run interactive spell checker (by default LANG="en_GB"
and UTF-8 encoding is used) and UTF-8 encoding is used)
+sync enable synchronization between source file and the
resulting DVI or PDF file
+o open PDF (or DVI) file after compilation +o open PDF (or DVI) file after compilation
+p use 'ps4pdf' instead of 'pdflatex'/'latex' (PSTricks) +p use 'ps4pdf' instead of 'pdflatex'/'latex' (PSTricks)
-V print script version -V print script version
@ -166,6 +178,7 @@ ${txtbld}Examples${txtrst}:
pdflatex.sh file.tex pdflatex.sh file.tex
pdflatex.sh +b +i +o file.tex pdflatex.sh +b +i +o file.tex
pdflatex.sh +p file.tex pdflatex.sh +p file.tex
pdflatex.sh +h beamer-presentation.tex
pdflatex.sh -kk file.tex pdflatex.sh -kk file.tex
pdflatex.sh -gs img/ pdflatex.sh -gs img/
pdflatex.sh -2x1 file.pdf pdflatex.sh -2x1 file.pdf
@ -359,7 +372,12 @@ function spell_checker() {
# Runs (pdf)latex # Runs (pdf)latex
function run_pdflatex() { function run_pdflatex() {
echo -ne "$TEXT..." echo -ne "$TEXT..."
$LATEX_PROGRAM $LATEX_BATCHMODE_OPT "$FILENAME" >&- 2>&- if [[ -n $APPENDSYNCTEX ]] ; then
$LATEX_PROGRAM $PDFLATEX_SYNCTEX_OPT $LATEX_BATCHMODE_OPT \
"$FILENAME" >&- 2>&-
else
$LATEX_PROGRAM $LATEX_BATCHMODE_OPT "$FILENAME" >&- 2>&-
fi
local ERR=`grep -i error "$FILENAME".log` local ERR=`grep -i error "$FILENAME".log`
if [[ -n $ERR ]] ; then if [[ -n $ERR ]] ; then
echo -ne "\t\t\t\t${txtred}[done]" echo -ne "\t\t\t\t${txtred}[done]"
@ -370,6 +388,14 @@ function run_pdflatex() {
fi fi
} }
# Sets (La)TeX beamer preamble for handouts
function beamer_handout() {
sed -e 's/\\documentclass\[/\\documentclass[handout,/g'\
-e 's/\\documentclass{/\\documentclass[handout]{/g'\
$FILENAME.tex > $FILENAME-handout.tex || die
FILENAME=$FILENAME-handout
}
# THE SCRIPT # THE SCRIPT
# ========== # ==========
@ -384,26 +410,29 @@ while [[ -n $1 ]] ; do
-2x1) pdf_manipulation "2x1" "$2" ; exit 0 ;; -2x1) pdf_manipulation "2x1" "$2" ; exit 0 ;;
-2x2) pdf_manipulation "2x2" "$2" ; exit 0 ;; -2x2) pdf_manipulation "2x2" "$2" ; exit 0 ;;
+3) THRICE="2" ; shift ;; +3) THRICE="2" ; shift ;;
+b) MAKEBIBTEXARG="yes" ; shift ;; +b) MAKEBIBTEXARG="true" ; shift ;;
-b) MAKEONLYBIBTEXARG="yes" ; shift ; break ;; -b) MAKEONLYBIBTEXARG="true" ; shift ; break ;;
-c) AUXILIARYEXTS="$AUXILIARYEXTS log dvi" ; cleanup "$2"; exit 0 ;; -c) AUXILIARYEXTS="$AUXILIARYEXTS log dvi synctex.gz" ; cleanup "$2"; \
exit 0 ;;
-gs) CONVERTIMGARG="svg" ; shift ; convert_images "$@" ; break ;; -gs) CONVERTIMGARG="svg" ; shift ; convert_images "$@" ; break ;;
-rs) CONVERTIMGRARG="svg" ; shift ; convert_images "$@" ; break ;; -rs) CONVERTIMGRARG="svg" ; shift ; convert_images "$@" ; break ;;
-gd) CONVERTIMGARG="dia" ; shift ; convert_images "$@" ; break ;; -gd) CONVERTIMGARG="dia" ; shift ; convert_images "$@" ; break ;;
-rd) CONVERTIMGRARG="dia" ; shift ; convert_images "$@" ; break ;; -rd) CONVERTIMGRARG="dia" ; shift ; convert_images "$@" ; break ;;
-h) print_help ; exit 0 ;; -h) print_help ; exit 0 ;;
+i) MAKEINDEXARG="yes" ; shift ;; +h) MAKEHANDOUT="true" ; shift ;;
-i) MAKEONLYINDEXARG="yes" ; shift ; break ;; +i) MAKEINDEXARG="true" ; shift ;;
-k) CHKTEX="yes" ; shift ; break ;; -i) MAKEONLYINDEXARG="true" ; shift ; break ;;
-kk) CHKTEX_OPT="$CHKTEX_OPT -n all" ;\ -k) CHKTEX="true" ; shift ; break ;;
CHKTEX="yes" ; shift ; break ;; -kk) CHKTEX_OPT="$CHKTEX_OPT -n all" ; \
CHKTEX="true" ; shift ; break ;;
-l) shift ; line_width "$@" ; break ;; -l) shift ; line_width "$@" ; break ;;
-n) hardspaces "$2"; exit 0 ;; -n) hardspaces "$2" ; exit 0 ;;
-s) sentences "basic" "$2" ; exit 0 ;; -s) sentences "basic" "$2" ; exit 0 ;;
-ss) sentences "strict" "$2" ; exit 0 ;; -ss) sentences "strict" "$2" ; exit 0 ;;
-sc) shift ; spell_checker "$@" ; break ;; -sc) shift ; spell_checker "$@" ; break ;;
+o) OPENPDFARG="yes" ; shift ;; +sync) APPENDSYNCTEX="true" ; shift ;;
+p) USEPS4PDFARG="yes" ; shift ;; +o) OPENPDFARG="true" ; shift ;;
+p) USEPS4PDFARG="true" ; shift ;;
-[vV]) echo "$THEREALNAME $VERSION" ; echo ; exit 0 ;; -[vV]) echo "$THEREALNAME $VERSION" ; echo ; exit 0 ;;
-*) echo -ne "Unknown switch: ${txtylw}$1${txtrst}." ; -*) echo -ne "Unknown switch: ${txtylw}$1${txtrst}." ;
echo " Type: \"${txtbld}$THEREALNAME -h${txtrst}\" for help." ; echo " Type: \"${txtbld}$THEREALNAME -h${txtrst}\" for help." ;
@ -423,6 +452,14 @@ if [[ -z $OUTPUT_DIRECTORY && -n $1 ]] ; then
fi fi
if [[ -n $OUTPUT_DIRECTORY ]] ; then cd $OUTPUT_DIRECTORY ; fi if [[ -n $OUTPUT_DIRECTORY ]] ; then cd $OUTPUT_DIRECTORY ; fi
# Beamer handouts (part 1 of 2)
if [[ -n $MAKEHANDOUT ]] ; then
if [[ ! -e $FILENAME.tex ]] ; then
die "Source file ${txtylw}$FILENAME.tex${txtrst} missing."
fi
beamer_handout
fi
# 'chktex' command # 'chktex' command
if [[ -n $CHKTEX ]] ; then if [[ -n $CHKTEX ]] ; then
check_programs "$CHKTEX_PROGRAM" check_programs "$CHKTEX_PROGRAM"
@ -511,8 +548,13 @@ else
else else
echo "${txtgrn}[done]${txtrst}" echo "${txtgrn}[done]${txtrst}"
echo -ne "$TEXT...\t\t\t\t" echo -ne "$TEXT...\t\t\t\t"
$LATEX_PROGRAM $LATEX_BATCHMODE_OPT "$PS4PDF_LATEX_OPT \ if [[ -n $APPENDSYNCTEX ]] ; then
\input{$FILENAME}" >&- 2>&- $LATEX_PROGRAM $PDFLATEX_SYNCTEX_OPT $LATEX_BATCHMODE_OPT \
"$PS4PDF_LATEX_OPT \input{$FILENAME}" >&- 2>&-
else
$LATEX_PROGRAM $LATEX_BATCHMODE_OPT "$PS4PDF_LATEX_OPT \
\input{$FILENAME}" >&- 2>&-
fi
echo "${txtgrn}[done]${txtrst}" echo "${txtgrn}[done]${txtrst}"
AUXILIARYEXTS="$AUXILIARYEXTS log" AUXILIARYEXTS="$AUXILIARYEXTS log"
fi fi
@ -524,6 +566,15 @@ if [[ $LATEX_PROGRAM != "latex" ]] ; then
fi fi
cleanup "$FILENAME" cleanup "$FILENAME"
# Beamer handouts (part 2 of 2)
if [[ -n $MAKEHANDOUT ]] ; then
pdf_manipulation "2x2" "$FILENAME.pdf"
echo -ne "${txtund}BEAMER HANDOUTS${txtrst}..."
mv -f $FILENAME-nup.pdf $FILENAME.pdf 2>&- || die
rm -f $FILENAME.tex 2>&- || die
echo -e "\t\t\t${txtgrn}[done]${txtrst}"
fi
# PDF browser # PDF browser
if [[ -n $OPENPDFARG && -e $FILENAME.pdf ]] ; then if [[ -n $OPENPDFARG && -e $FILENAME.pdf ]] ; then
check_programs "$PDF_VIEWER_PROGRAM" check_programs "$PDF_VIEWER_PROGRAM"