<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">David,<div><br></div><div>How did you get the java-like source highlighting working in Swift code? I was trying similar syntax but getting this error on asciidoc compile:</div><div><br></div><div>filter non-zero exit code: source-highlight -f xhtml -s java: returned 127</div><div><br></div><div>--</div><div>Ketan</div><div><br><div><div>On Apr 25, 2011, at 9:09 PM, David Kelly wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Hello,<br><br>I created a first draft of the Swift tutorial in asciidoc. Here are the documents it created:<br><br>HTML: <a href="http://www.ci.uchicago.edu/~davidk/tutorial.html">http://www.ci.uchicago.edu/~davidk/tutorial.html</a><br>
PDF: <a href="http://www.ci.uchicago.edu/~davidk/tutorial.pdf">http://www.ci.uchicago.edu/~davidk/tutorial.pdf</a><br>ASCIIDOC: <a href="http://www.ci.uchicago.edu/~davidk/tutorial.txt">http://www.ci.uchicago.edu/~davidk/tutorial.txt</a><br>
<br>There are still a few things I need to tweak, but overall I'm finding asciidoc pretty nice to work with.<br><br>The ticket that was created for this, 375, mentions that these documents should be created during ant dist. But I think most people do not have asciidoc installed by default, and including it with Swift will not be possible due to GPL licensing issues. Asciidoc itself is GPL, as well as the various packages it depends on - source-highlight for code highlighting, and dblatex for generating PDFs.<br>
<br>I think Justin's suggestion of keeping document generation limited to a CI machine is the way to go. If that makes sense to you all, I will start on a script to generate the documents, and continue working on manually converting the rest of the documentation material into asciidoc format.<br>
<br>David<br><br><div class="gmail_quote">On Sat, Apr 23, 2011 at 1:00 PM, Justin M Wozniak <span dir="ltr"><<a href="mailto:wozniak@mcs.anl.gov">wozniak@mcs.anl.gov</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<br>
Yeah- I am trying to be more careful with umask. Please send me your error message and I will modify the chmods in the script accordingly.<br>
<br>
For the new structure, I recommend that we stop using svn to move the content and just push the simple documents. I would be fine with a cp-based method that only works from a CI system.<div class="im"><br>
<br>
On Sat, 23 Apr 2011, Michael Wilde wrote:<br>
<br>
</div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div class="im">
Looking deeper into this, I see that the permissions in /ci /www/projects/swift do not permit anyone in vdl2-svn to do svn-update and to run update.sh completely for the entire doc set.<br>
<br>
<br>
Justin, I think this occurred when you last worked on this directory. Can you see if update.sh works for you at the moment? That should push David's committed tutorial corrections to the live content.<br>
<br>
<br>
I suggest that rather than correct this, we push ahead updating the entire per-release doc set to asciidoc and then adjust update.sh and the /ci/www/projects/swift directory to match it. David, can you do this under bug 375, and propose the new structure with a README that outlines how all the directories and content-push scripts will be organized?<br>
<br>
<br>
Thanks,<br>
<br>
<br>
Mike<br>
<br>
<br></div><div class="im">
----- Original Message -----<br>
<br>
<br>
<br>
David, you're not in the vdl2-svn UNIX group, which you need in order to run this. I'll request that you be added, and do an svn-co of the tutorial and run update.sh for you in the meantime.<br>
<br>
<br>
- Mike<br>
<br></div><div class="im">
----- Original Message -----<br>
<br>
<br>
Hello,<br>
<br>
<br>
What is the current process for updating website documentation? I believe the MaintainingSwiftWebContent wiki may be out of date.<br>
<br>
<br>
I am trying to submit some corrections to the Swift tutorial. Previously I could modify it through www/ in SVN. Now I believe it is generated from swift/docs/tutorial.xml for each release. Is this correct? Is there still a cron job that runs daily and updates the site? I am not seeing the changes I made yesterday reflected on the website. Do I need to manually run /ci/www/projects/swift/update.sh? I do not have permissions to read or execute it at the moment.<br>
<br>
<br>
Thanks,<br>
David<br>
<br>
<br>
_______________________________________________<br>
Swift-devel mailing list<br>
<a href="mailto:Swift-devel@ci.uchicago.edu" target="_blank">Swift-devel@ci.uchicago.edu</a><br>
<a href="http://mail.ci.uchicago.edu/mailman/listinfo/swift-devel" target="_blank">http://mail.ci.uchicago.edu/mailman/listinfo/swift-devel</a><br>
<br>
<br>
<br>
<br>
</div></blockquote>
<br>
-- <br><font color="#888888">
Justin M Wozniak<br>
</font></blockquote></div><br>
_______________________________________________<br>Swift-devel mailing list<br><a href="mailto:Swift-devel@ci.uchicago.edu">Swift-devel@ci.uchicago.edu</a><br>http://mail.ci.uchicago.edu/mailman/listinfo/swift-devel<br></blockquote></div><br></div></body></html>