<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<style type="text/css" style="display:none;"><!-- P {margin-top:0;margin-bottom:0;} --></style>
</head>
<body dir="ltr">
<div id="divtagdefaultwrapper" style="font-size:12pt;color:#000000;font-family:Calibri,Helvetica,sans-serif;" dir="ltr">
<div id="divtagdefaultwrapper" dir="ltr">
<p style="color: rgb(0, 0, 0); font-family: Calibri, Helvetica, sans-serif, Helvetica, EmojiFont, 'Apple Color Emoji', 'Segoe UI Emoji', NotoColorEmoji, 'Segoe UI Symbol', 'Android Emoji', EmojiSymbols; font-size: 12pt;">
Alice, all:</p>
<p style="color: rgb(0, 0, 0); font-family: Calibri, Helvetica, sans-serif, Helvetica, EmojiFont, 'Apple Color Emoji', 'Segoe UI Emoji', NotoColorEmoji, 'Segoe UI Symbol', 'Android Emoji', EmojiSymbols; font-size: 12pt;">
<br>
</p>
<p style="color: rgb(0, 0, 0); font-family: Calibri, Helvetica, sans-serif, Helvetica, EmojiFont, 'Apple Color Emoji', 'Segoe UI Emoji', NotoColorEmoji, 'Segoe UI Symbol', 'Android Emoji', EmojiSymbols; font-size: 12pt;">
The new PUI PDF process does *not* use EAD or the as-ead.html.xsl file. Instead, it takes the data directly from ArchivesSpace, converts it to HTML, and then converts that HTML to PDF. For the ASpace PUI workshop I created a small plugin to illustrate how
you can change the image that's added to the front page of the PDF. I haven't had a chance to provide other examples yet (or even to delve too deeply into how the new PDF creation process works), but here is where some of those files live in the ArchivesSpace
core code: <span style="font-size: 12pt;"><a href="https://github.com/archivesspace/archivesspace/tree/master/public/app/views/pdf" class="OWAAutoLink" id="LPlnk232377" previewremoved="true">https://github.com/archivesspace/archivesspace/tree/master/public/app/views/pdf</a> </span><br>
</p>
<p style="color: rgb(0, 0, 0); font-family: Calibri, Helvetica, sans-serif, Helvetica, EmojiFont, 'Apple Color Emoji', 'Segoe UI Emoji', NotoColorEmoji, 'Segoe UI Symbol', 'Android Emoji', EmojiSymbols; font-size: 12pt;">
<span style="font-size: 12pt;"><br>
</span></p>
<p><font size="3">If you follow the model of the "local" plugin that's already provided </font>with<font size="3"> ArchivesSpace, here's how you'd change the image on the front page of the PDF:</font></p>
<p><font size="3"><br>
</font></p>
<p></p>
<ul style="margin-bottom: 0px; margin-top: 0px;">
<li><font size="3">Add a "public" directory to the local plugin, and add an "assets" subdirectory (for your new image) and a "views" subdirectory (which can be used to override the default behaviors of the PDF process).</font></li><li><font size="3">In the "assets" directory, add something like "images/logo.png"</font></li><li><font size="3">In the "view" directory, I added the following: pdf/_header.html.erb. </font></li><li><font size="3">In that _header.html.erb file, I kept everything the same as what's in the default file, aside from this last bit:</font></li></ul>
<div><br>
</div>
<p></p>
<div> <div class="logo"></div>
<div> <img src="<b>/assets/images/logo.png</b>"/></div>
<span style="font-size: 12pt;"> </div></span></div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
</div>
<div id="divtagdefaultwrapper" dir="ltr"><span style="font-size: 12pt;"></span>As long as you then have the "local" plugin turned on, you can then use this technique to change the default image as well as anything else in the PDF. </div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
</div>
<div id="divtagdefaultwrapper" dir="ltr">I hope that helps, and I hope to have this more fully documented soon once it's been explored a bit more. I was actually hoping to re-use the pre-exisitng XSL transformations (primarily since that's what I know!), but
I believe that this approach results in PDFs much more quickly, since the EAD file also doesn't have to be generated. The other benefit, which may take a while to show its usefulness, is that you don't need to know EAD or XSLT to update the PUI PDFs. Instead,
you need to know a bit about ArchivesSpace and HTML (and lots more people know about HTML than know about EAD or XSLT).</div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
</div>
<div id="divtagdefaultwrapper" dir="ltr">Please let us know if you're able to change the PDF using this plugin approach or not, and if you have any feedback about it. So far, all that I've done was test that I could change the logo that's used, but it would
be great to develop other types of customizations so that those can be shared with the rest of the community.</div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
</div>
<div id="divtagdefaultwrapper" dir="ltr">mark</div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
</div>
<div id="divtagdefaultwrapper" dir="ltr"><br>
<br>
<hr tabindex="-1" style="color: rgb(0, 0, 0); font-family: Calibri, Helvetica, sans-serif, Helvetica, EmojiFont, 'Apple Color Emoji', 'Segoe UI Emoji', NotoColorEmoji, 'Segoe UI Symbol', 'Android Emoji', EmojiSymbols; font-size: 12pt; display: inline-block; width: 98%;">
</div>
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" color="#000000" style="font-size:11pt"><b>From:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org> on behalf of Alice Elizabeth
Tippit <a-tippit@northwestern.edu><br>
<b>Sent:</b> Wednesday, August 30, 2017 11:40:41 AM<br>
<b>To:</b> archivesspace_users_group@lyralists.lyrasis.org<br>
<b>Subject:</b> [Archivesspace_Users_Group] Customizing the Public Interface PDF</font>
<div> </div>
</div>
<div>
<div class="WordSection1">
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Greetings all,</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">We would like to customize the PDF that generates from the public interface, but are having difficulty figuring out which of the xsl files in the stylesheets folder is used to generate the PDF,
and where to place our customized files.</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">When the “Print” button is clicked in our Public interface, a PDF is automatically generated. In comparison the PDF produced through the staff interface it lacks the useful table of contents
and has formatting that produces a document that is twice the number of pages.</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Notes from the public interface session held at the ArchivesSpace Forum indicate that we need to customize the as-ead-html.xsl file as a plugin:</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black">>PDF from PUI is NOT generated from EAD-->PDF XSL (comes from HTML) so to customize PDF you would have to use a plugin; PDF on staff side still is from XSL<</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black">Adding to our confusion, when we run the as-ead-html.xsl file through Oxygen the html document produced has a table of contents, and formatting that is easier on the eyes. No idea
what it looks like converted into a PDF. I’d hope for something better than the PDF that currently generates on the public site.</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black">Following the note from the public session as best we can, we attempted a test, placing a customized copy of the as-ead-html.xsl file in archivesspace > plugins > local > public
> stylesheets. This had no effect.</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black">Are we chasing the wrong file, or placing it in the wrong location? Or something else…</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:black">For interested folks, I’ve attached the html file produced by running the as-ead-html.xsl file through Oxygen, as well as the PDFs currently produced on the Public and Staff interface.</span><span style="font-family:"Arial",sans-serif"></span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Any advice—thank you!</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif"> </span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Alice Tippit</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Developer-Metadata & Discovery Services</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Northwestern University Library</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif; color:#4E2A84">Northwestern University</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">1970 Campus Drive
</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">Evanston, IL 60208</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">www.library.northwestern.edu</span></p>
<p class="MsoNormal"><span style="font-family:"Arial",sans-serif">a-tippit@northwestern.edu</span></p>
<p class="MsoNormal"> </p>
</div>
</div>
</div>
</body>
</html>