A converter from SMJ AMS-TeX to Springer A++ XML
by Alexander E. Gutman <gutman@math.nsc.ru>
(c) Siberian Mathematical Journal

Install SMJXML

  1. For Windows 10 and later, allow the user to create symbolic links:

     * execute "gpedit.msc" to open "Local Group Policy Editor";
     * in the tree on the left, select
        "Computer Configuration" -> "Windows Settings"
        -> "Security Settings" -> "Local Policies"
        -> "User Rights Assignment";
     * in the list on the right, double-click "Create symbolic links";
     * in the dialog opened, click "Add User or Group...";
     * in the subdialog opened, type your windows user name,
       click "Check Names", and then click "OK";
     * click "OK" in the previous dialog and reboot.

  2. Copy the entire content of this folder including all subfolders
     into any folder whose full path consists of US-ASCII characters
     and does not contain spaces. (The folder will be referred to
     as the SMJXML folder.)

  3. Navigate into the SMJXML folder and execute "Install.cmd".

  4. If the SMJXML folder is moved to another location,
     execute "Install.cmd" within the new location.

  5. Prior to using SMJXML make sure that Perl is installed.

  6. Execute "Uninstall.cmd" if SMJXML is no longer needed.

Prepare an issue folder

  1. Copy all the "*.ams" files of the journal issue (including
     the assembly file "00YY_I.ams") and optional image files
     "*.eps" and "*.png" into a folder whose path consists of
     US-ASCII characters and does not contain spaces. (The folder
     will be referred to as IssueFolder.)

  2  Make sure that all image files used by articles "*.ams"
     have names that start with "*.ams+". (For instance,
     the image files used by article "3456_e.ams" can be named
     as "3456_e.ams+1.eps" and "3456_e.ams+1.png".)

  3. Copy "Convert.cmd" from the SMJXML folder into IssueFolder.

  4. In the assembly file, insert \openData{NNNN} before the \Input...
     commands and \closeData after the \Input... commands,
     where "NNNN" is the last ArticleID of the previous issue.
     This ArticleID can be found in the previous "Issue.json" file
     in the last line of the form "simj****": [**,NNNN,****,**,**]

  5. TeX-compile the assembly file several times to create a file
     named "Data.ps1" in IssueFolder.

Convert and correct the articles

  1. Navigate into IssueFolder, execute "Convert.cmd", choose
     "1. Process articles / (o) Convert articles", and click "Run"
     or press "Enter". (You may also check/uncheck tasks and options
     by pressing the keys "1","2","3","4","5","6","c","r","v",
     while "Esc" closes the dialog without any subsequent actions.)

  2. Check the conversion results: read "Convert.log" in IssueFolder
     and "Convert.log" files in subfolders "IssueFolder\XML\NNNN",
     where NN are the article numbers and MMMM, the names of "*.ams".

  3. To correct an article, navigate into the corresponding folder
     "IssueFolder\XML\NNNN", edit the "*.ams" file therein
     (which is a symbolic link to the same file in IssueFolder),
     and execute the local "Convert.cmd" file. Read "Convert.log"
     and repeat the procedure to eliminate all errors.

Create a draft Springer XML package

  1. Navigate to IssueFolder, execute "Convert.cmd" once again,
     choose "1. Process articles / (o) Verify articles"
     (or choose "(o) Refresh articles" if the article XML files
     are obsolete and the corresponding message is displayed,
     or choose "(o) Convert articles" for a complete conversion if
     you want to make sure that all changes to "*.ams" are applied),
     check "2. Create Springer XML package", and click "Run".

  2. The resultant Springer XML package consists of three files
     located in "IssueFolder\Package": "X.zip", "X.zip.delivered",
     where "X" is a long string (~70 characters), and "Issue.json".
     (A file "DOI.csv" also appears in "IssueFolder\Package"
     which contains the list of DOIs of all articles in this issue.
     After conversion to "DOI.xls" or "DOI.xslx", this file can be
     later included in the package for the publisher's curator.)

Inspect the online version of a Springer XML package

  1. For converting the XML package into HTML and PDF, copy "X.zip"
     and, separately, "X.zip.delivered" into the "XMLtoPDF\Input"
     FTP folder of the Pleiades XML FTP service. In a few minutes
     (you may wait for a notification email) get the processed
     "X_out.zip" file from the "XMLtoPDF\Output" FTP folder.
     Delete "IssueFolder\HTML" if that folder exists and unzip
     the "HTML" subfolder of "X_out.zip" as a new "IssueFolder\HTML".

  2. Examine the PDF and HTML files located in "***_Article"
     subfolders of "IssueFolder\HTML". (You may also click
     internal links to check their behavior.)

  3. To correct any defects, make changes to the "*.ams" files,
     recreate the draft Springer XML package, convert it via Pleiades
     "XMLtoPDF" service, and inspect the new online content.

Create a complete Springer XML package

  1. TeX-compile the assembly file "00YY_I.ams", and make sure
     that the "split.ba(t)" file appeared in IssueFolder.
     (Add or uncomment the "\opensplit=split.ba" line in the assembly
     file and TeX-compile it to create "split.ba(t)" in IssueFolder.)
     By executing "split.ba(t)", create "simj****.ps" files, process
     them via the Pleiades "Distiller" FTP service, and download
     the resultant "simj****.pdf" files into any temporary folder.

  2. Create a new (or clean the existent) folder "IssueFolder\PDF".
     Process "simj****.pdf" files via the Pleiades "PitStopServer"
     FTP service and download the newly obtained "simj****.pdf" files
     into "IssueFolder\PDF", and "simj****_log.pdf" files
     into "IssueFolder\PDF" or "IssueFolder\PDF\log".

  3. Later, after Pleiades sends a cover TIF file for the issue,
     place it into "IssueFolder\PDF" under the name of "Cover.tif".

  4. Navigate to IssueFolder, execute "Convert.cmd",
     choose "1. Process articles / (o) Verify articles"
     (or choose "(o) Refresh articles" if the article XML files
     are obsolete and the corresponding message is displayed,
     or choose "(o) Convert articles" for a complete conversion if
     you want to make sure that all changes to "*.ams" are applied),
     check "2. Create Springer XML package", and click "Run".

  5. The resultant Springer XML package consists of three files
     located in "IssueFolder\Package": "X.zip", "X.zip.delivered",
     where "X" is a long string (~70 characters), and "Issue.json".
     (A file "DOI.csv" also appears in the same folder, see above.)

Proofread the complete Springer XML package

  1. For converting the XML package into HTML and PDF, copy "X.zip"
     and, separately, "X.zip.delivered" into the "XMLtoPDF\Input"
     FTP folder of the Pleiades XML FTP service. In a few minutes
     (you may wait for a notification email) get the processed
     "X_out.zip" file from the "XMLtoPDF\Output" FTP folder.
     Delete "IssueFolder\HTML" if that folder exists and unzip
     the "HTML" subfolder of "X_out.zip" as a new "IssueFolder\HTML".

  2. Navigate into IssueFolder, execute "Convert.cmd", optionally
     uncheck unnecessary tasks, check "3. Create Proof subfolder",
     and click "Run". Compare "Online.pdf" and "Print.pdf" files
     located in "IssueFolder\Proof\NNNN" to make sure that all
     formulas are correctly converted and there are no significant
     presentation defects. You may also examine "Online.html" files
     and click internal links to examine their behavior.

  3. To correct any defects, make changes to the "*.ams" files,
     recreate the Springer XML package, convert it via Pleiades
     "XMLtoPDF" service, and proofread the new content.

  4. For getting the authors to take part in proofreading, navigate
     into IssueFolder, execute "Convert.cmd", optionally uncheck
     unnecessary tasks, check "4. Create ProofZips subfolder",
     and click "Run" to create "IssueFolder\ProofZips\NNNN.zip"
     files (one for each article) that can be sent to the authors.

  5. For proofreading a single article "NNNN_e.ams" separately from
     the rest of the issue, you can create a mini-issue consisting
     of a single article. To do this, execute the "Issue.cmd" file
     located in the "IssueFolder\XML\NNNN" subfolder. As a result,
     the "IssueFolder\XML\NNNN\Issue" subfolder will be created,
     which is a full-fledged issue folder whose assembly file
     "Issue.ams" includes only "NNNN_e.ams".

Create the final Pleiades files

  1. Request Pleiades for the actual cover TIF file of the issue and
     place it into "IssueFolder\PDF" under the name of "Cover.tif".

  2. Navigate to IssueFolder, execute "Convert.cmd",
     choose "1. Process articles / (o) Verify articles"
     (or choose "(o) Refresh articles" if the article XML files
     are obsolete and the corresponding message is displayed,
     or choose "(o) Convert articles" for a complete conversion if
     you want to make sure that all changes to "*.ams" are applied),
     check "2. Create Springer XML package", and click "Run".

  3. Make sure that the content of "IssueFolder\HTML" is up to date.
     To update the content of "IssueFolder\HTML", copy "X.zip"
     and, separately, "X.zip.delivered" into the "XMLtoPDF\Input"
     FTP folder of the Pleiades XML FTP service. In a few minutes
     (you may wait for a notification email) get the processed
     "X_out.zip" file from the "XMLtoPDF\Output" FTP folder.
     Delete "IssueFolder\HTML" if that folder exists and unzip
     the "HTML" subfolder of "X_out.zip" as a new "IssueFolder\HTML".

  4. Process the XML package via Pleiades "Submission Checker":
     copy "X.zip" and, separately, "X.zip.delivered" into the
     "SubmissionChecker\In" FTP folder of Pleiades XML FTP service
     and, in a few minutes, inspect the content of "Out", "Redo",
     and "Success" FTP subfolders of "SubmissionChecker" FTP folder:
     "Out" will contain the original "X.zip", "Redo" should be empty,
     and "Success" should contain a single "*.log" file.

  5. Copy the "*.log" file from "SubmissionChecker\Success" into
     "IssueFolder\Package".

  6. If the name of the "*.log" file copied at step 4 differs from "X"
     by a suffix of the form "_YYYY-MM-DD_HH-MM-SS", rename the file
     by removing the suffix.

  7. Navigate into IssueFolder, execute "Convert.cmd", optionally
     uncheck unnecessary tasks, check "5. Create Pleiades subfolder",
     and click "Run" to create the "IssueFolder\Pleiades" subfolder
     with files "X.zip", "X.log", and "PDF+JSON.zip". Send the
     three files to Pleiades via TrackStudio or email with subject
     "SIMJ I/YY FINAL", with "I" the issue number and "YY" the year.

Create the Abstracts subfolder

  1. Navigate to IssueFolder, execute "Convert.cmd",
     choose "1. Process articles / (o) Verify articles",
     check "6. Create Abstracts subfolder", and click "Run".

  2. As a result, in the "IssueFolder\Abstracts" subfolder,
     for each unhidden article of the issue, the corresponding
     "*.ams" file with the same name is created that contains
     the "author", "title", "keywords", and "abstract" sections
     of the article.
