Scripts and How to Run them to Produce Proceedings & Other Handy Reports

Contact: Volker RW Schaa (GSI Helmholtzzentrum für Schwerionenforschung GmbH)

Required Software

The JPSP scripts run under Linux/Unix and Windows. As most of the
software packages (perl, TeX, wget, etc.) are pre-installed in Linux,
only the installation under Windows is described here.

Perl for Windows:

The Perl install package Strawberry Perl is recommended.
It installs in a interactive way and adds its directory to the Windows path setting.

   64bit Perl - v. 5.26.1 - 94.4 MB

PDF utilities pdfinfo, pdftotext, pdffonts, . . .

The following PDF utilities are needed by some of the scripts: pdfinfo, pdftotext,
and pdffonts. These utilities are part of xpdf an open source viewer for PDF files
and can be downloaded from the xpdf site. The precompiled binaries can be downloaded
using the following link.

Install the binaries where they can be found from
a command prompt window (set path).

   PDF utilities - v4.0 - 11MB    

After unzipping copy all 9 pdf~~~~~.exe binaries from /bin64 to where they can be
found from a command prompt window (set path).

wget for Windows:

A file transfer utility is needed to download the XML output from the SPMS database
in an encoding safe way to use the script »spmsread.pl«, the generated download
command files (»pdfwget.bat«, »allwget.bat«, and others).

   64bit - wget64.exe module - v. 1.19.2

Install the binaries where they can be found from a command prompt window (set path).

cURL for Windows

For the DOI registration cURL is used as it provides more features and an easier
command line syntax as wget (see feature compare). In the future more operations
in the scripts will be implemented using cURL instead of wget.

   64bit 7z zip file  - v. 7.56.1 - 1.9MB

After unzipping copy the curl.exe binary from /bin to where it can be
found from a command prompt window (set path).

TeX for Windows

The TeX distribution MiKTeX is recommended as it is the only distribution
which provides on-the-fly download and installation of missing packages.

TeX is needed for wrapping the papers and incorporate information in
the hidden fields of the PDFs, print-out of Author-Title-Check pages,
proceedings volumes, and other tasks.

   MiKTeX installer ~200 MB

MiKTeX should be configured to download missing packages automatically
on-the-fly without additional questioning.
MiKTeX Settings => General => Install... => Yes.

JPSP - JACoW Proceedings Script Package

Setup of a local site for the JACoW JPSP scripts: download the
package and unzip it in the wanted directory. It will create a
directory structure used by the scripts. The main directory is
named like the package (SCS2018-171104), rename it to
your conference name (i.e. IPAC2021).

   JPSP - JACoW Proceedings Script Package v27.0

Configuration File

The most important entity is the configuration file conference.config.
It contains the description of all parameters needed for pre-conference,
during conference, and post-conference usage. It is part of the JPSP package and
has to be adapted to (at least) the conference name, location, SPMS links etc.

#*******************
version_config      = 2017-11-03
version_script_bt   = 27.0
#*******************
# Conference Setup (which is split between conference and post-conference setup.
#                   conference setup      is used for generating abstract booklet,
#                                         web pages, and proceedings
#                   post-conference setup is used to generate data for DOIs/INSPIRE etc.
#-----------------
#   conference
#           _SPMS      		contains the SPMS base directory for the conference, i.e. https://oraweb.cern.ch/pls/IPAC2013/
#           _xmlfile   		contains only the conference XML "filename", not the directory (like 'xml_directory')
#           _logo      		contains only the logo/banner image's "filename", not the directory (like 'img_directory') of the logo to be used on the banner page
#           _logo_size 		provides the "width"x"height" of the logo/banner as it should be displayed
#           _url       		URL where the conference proceedings will end up on the JACoW file server
#                        	(should be for JACoW http://jacow.org/<conference-name>/
#           _respm     		e-mail address of the responsible person for generating the web pages for the conference 
#           _name      		name of the conference (<conference-name><year>) conference name lowercase with 4 digit year
#           _site      		contains City and Country of the conference venue (<city>, [state,] country)
#           _title     		title of the conference (<title of conference>, i.e. 11th International Computational Accelerator Physics Conference)
#           _date      		<date of conference> i.e. "August 19-24, 2012" [<month> <date-range> <year> should be separated only by one space]
#           _series             base name of the conference without edition etc.
#           _number             event in the series
#           _pub_copyr 		"Copyright \copyright{} <current-year> CC-BY-3.0 and by the respective authors"
#
#	    _pre       		switch on/off Pre-Release run (1=yes | 0=no)
#	    _pre_text  		"- Pre-Release Snapshot <date> <time>" i.e. 07-Oct-2016 18:00
#
#
# post-conference setup 
#----------------------
#           _editor    		email of editorial board: "<last-name>, <first-name> (<affiliation>)[<id-origin:id>]", several editors are concatenated with ";"
#                               e.g. with ORCID: "Schaa, Volker RW (GSI, Darmstadt, Germany)[ORCID:0000-0003-1866-8570]" otherwise take JACoWId
#           _isbn      		JACoW ISBN of the conference (978-3-95450-xxx-y), please ask Volker RW Schaa if you are not sure, i.e. 978-3-95450-116-8
#           _pub_date           year and month (numerical) of publication on JACoW, i.e. "2012-10"
#           _pub_by    		"JACoW" (fix entry for nearly all conferences)
#                        		JACoW/IEEE for NA-PAC and IPACs in North America
#                        		JACoW/EPS for IPACs in Europe
#
#
#conference_SPMS      = https://<reginal-support-center>/pls/<conference>/ # base URL of login into SPMS instance
conference_SPMS      = https://oraweb.cern.ch/pls/icalepcs2017/
conference_xmlfile   = spms.xml
#*******************
# Conference parameters
#
conference_logo      = logo.png                                 # logo used for the banner frame 
conference_logo_size = 500x125                                  # (pixel) real logo size can be scaled to this size
conference_url       = http://jacow.org/icalepcs2017/           # (all lowercase!) where it will appear at JACoW (used for Inspire dataset)
conference_respm     = v.r.w.schaa@gsi.de                       # ends up in the generated html pages
conference_name      = ICALEPCS2017                             # e.g. IPAC2017, CYCLOTRONS2015, ...
conference_site      = Barcelona, Spain                         # e.g. "Barcelona, Spain" or "San Francisco, CA, USA"
conference_title     = 16th International Conference on Accelerator and Large Experimental Control Systems    # complete name including number
conference_date      = 8-13 October 2017			# date of conference
conference_series    = International Conference on Accelerator and Large Experimental Control Systems	      # series 
conference_number    = 16					# event in the series
# JACoW-id:                                                       to get the correct JACoWId, use https://oraweb.cern.ch/pls/jacow/xml2.author?ln=<lastname>&fn=<firstname>
# editorial board: <last-name>, <first-name> (<affiliation>)[<id-origin:id>]  + ";" as separator 
conference_editor    = "Costa, Isidre (ALBA-CELLS, Barcelona, Spain)[JACoWId:40625];Schaa, Volker RW (GSI, Darmstadt, Germany)[ORCID:0000-0003-1866-8570]"	
conference_isbn      = 978-3-95450-xxx-x                        # ISBN number (check http://www.jacow.org/Tools/ISBN or ask Volker if your conference is not listed)
conference_pub_date  = 2017-xx                                  # final publication date on JACoW
conference_pub_by    = JACoW                                    # a constant
conference_pub_copyr = Copyright \copyright{} 2017 CC-BY-3.0 and by the respective authors
#
conference_pre       = 1                                        # this run is only a Pre-Release (1=yes | 0=no => production run)
conference_pre_text  = - Pre-Release Snapshot 25-Oct-2017 12:30	# string will be attached to "conference_site" and printed on each paper
#
# DOI related settings
#	DOI_prefix	test:	10.5072	    <- everybody can use this
#	          production:	10.18429    <- JACoW assigned DOI number
#
#       DOI_site publication:       http://jacow.org/<conference_name>/doi/
#				=>    http://accelconf.web.cern.ch/AccelConf/<conference_name>/doi/
#               if not defined      http://jacow.org/<conference_name>/doi/
#
#DOI_prefix	    = 10.18429                 		    	# JACoW's production domain
DOI_prefix	    = 10.5072                                  	# test domain
DOI_useraccount     = --user CERN.JACOW:DataCite.######		# do not propagate <password>
###DOI_site         = http://jacow.org/<conference-name>/doi/	# site of DOI landing page (when commented out "#"; generated automatically
#                                                           	# when not set or defined, the standard is used: http://jacow.org/<conference>/doi/ 
#                                                           	#                       => http://accelconf.web.cern.ch/AccelConf/<conference>/doi/
data_generation_date = 2017-mm-dd			    	# date the proceedings were generated and published <yyyy-mm-dd>
#*******************
# other files
#
protocol_directory  = ./PROTOCOL/
debug_file          = protocol.txt
deb_calltree        = 0                                         # only for debug purpose (=1)
#*******************
# directory configuration (alphabetical order)
# all directory names with "#" are UPPERCASE directories, 
#               only contain material and do NOT go into the proceedings
#
#    atc_        #	place for Author-Title-Check files
#    audio_       	for audio recordings
#    base_url     	base for reference links from docs, papers, pages [index.html]
#    content_    #	this is where the time-schedule, dividing sheets, pictures, etc. are coming from
#    doi_		for the DOI landing page within the conference standard
#    doixml_	 #      for the DOI XML data and registration batch file
#    export_      	for all files which have to do with citations or references to this article (<papercode>-[bib|ris|tex|txt].htm + <papercode>.xml)
#    html_        	for all html-files [.htm]
#                       (author, keyword, institute, session, ...)
#    img_         	for all images [.png, .jpg, .gif, ...]
#    paper_       	for all papers *with* embedded infos [.pdf]
#                       (keyword/author/..., conference tag, page numbers, etc.)  [.pdf]
#    poster_      	for all poster files (<papercode>_poster.pdf)
#    raw_paper_  #	for all papers *without* embedded infos [.pdf] (the processed files from JACoW editors) +
#                       all files needed for error checking (<paper_code>-[i|k|f].txt info/keywords/fonts etc.)
#    slides_      	for all transparency files (<papercode>_talk.pdf)
#    video_       	for video recordings (mp4, m4v, .etc)
#    xml_        #	for all xml related files (downloaded sessions and complete conference)
#
base_url            = ../index.htm
atc_directory       = ./ATC/
audio_directory     = ../audio/
video_directory     = ../video/
content_directory   = ./CONTENTS/
html_directory      = ./html/
slides_directory    = ../talks/
img_directory       = ../im0ges/
paper_directory     = ./papers/
raw_paper_directory = ../PAPERS-FINAL/
xml_directory       = ./XML/
poster_directory    = ../posters/
export_directory    = ./export/
doi_directory       = ./doi/
doixml_directory    = ./DOIXML/
#*******************
# Security Pass Phrases (to be copied from SPMS)
#
PassPhraseDown      = <pass-phrase-down>
PassPhraseUp        = <pass-phrase-up>
PassPhraseExtract   = <pass-phrase-extract>
#------------------------------------------------------------
# download ALL (=0) PDFs or only update the ones missing (=1)
pdf_update_only     = 0                 # 0 = no, download all; 1 = yes, only download new ones
#*******************
# paper_not_received_link = "0|1"
#   if "paper_not_received_link = 0" no TeX and PDF files will be generated
#   for missing papers, therefore no link in any of the lists (session, 
#   classification, author, and keyword) will be generated. In this case the 
#   entry in "paper_not_received_text" will not be used
#
# paper_not_received_text = "text"
# text to be put in papers when the final text has not been sent by the author
#   DIPAC2003 used "PAPER NOT YET RECEIVED" before finalizing
#              and "PAPER NOT RECEIVED" after submission stop
#   EPAC      uses "CONTRIBUTION NOT RECEIVED"
#
#	Pre-Release	use "Paper not yet received, processed, or QAed"
#
paper_not_received_text   = CONTRIBUTION NOT RECEIVED
paper_not_received_link   = 0
#*******************
paper_ftn_switch          = 1     # footnotes will (not=0) be included
paper_agy_switch          = 1     # funding notes will (not=0) be included
proceedings_volume_switch = 1     # Proceedings volume will (not=0) be produced
context_switch            = 0     # (do not=0) generate a ConTeXt abstract booklet
abslatex_switch           = 1     # do (not=0) generate an E/PAC sytle abstract booklet
TeXhighlite               = blue  # color defined at date: blue/black
paper_strike_thru         = 1     # missing PDFs will (=1) not (=0) lead to strike-through paper-codes
citation_export           = 1     # export citations: set it to "1" when producing the proceedings
#*******************
#
# session/page related settings
# 
session_skip              = "|SUSPSNE|" # this or these sessions should be skipped when generating the web pages; each session name is embedded 
#                                        #   in "|" characters, when defining several sessions it should be writen as "|SESS-A|SESS-B|COFFEE|LUNCH|"
paper_skip	          = "|WEPSB062|WEPSB072|" # this or these papers will be skipped when generating the web pages; each paper has a "|" as separator
#*******************
#
# "P"aper numbers "P"er "L"ine (PPL) 
#     configurable number of paper codes listed for an author
#
#*******************
PPL_ltx                   = 3     # number for LaTeX Author index in Proceedings (=3)  (Abstract booklet normally 6)
PPL_ctx                   = 3     # number for ConTeXt Author index in Abstract booklet
PPL_xtx                   = 3     # number for XeTeX Author index in Abstract booklet
#*******************
#
# InDiCo specific settings
#
#*******************
indico_cut_of_trailing_ho  = yes  # InDiCo session names contain trailing "-1" strings, these will be cut off
indico_uppercase_session   = yes  # InDiCo session names are often lowercase and this option makes it automatically UPPERCASE
indico_code_prefix         = XB-  # InDiCo papers and talks just consist of an unique ID, this string will be prefixed to all IDs
#*******************
#
# abstract related settings
# 
abstract_omission_text     = "no idea where the abstract went"       # standard text is "no abstract available"  
abstract_insert            = yes  # it's a semi-InDiCo specific switch because InDiCo's papers mostly do not have abstracts, 
#                                 # but 'old' reprocessed conferences don't either. ("yes" means get Abstract for paper <paper_code>.abs
#                                 # via  scan_keywords.pl or typed one)
#