Hello All,<br><br>Note: Scott is probably the only one who will care about this.<br><br>When I started at Galaxy I created Nabble Archives for the Galaxy Mailing lists, just like I did at GMOD. Nabble archives are far better than Sourceforge or Mailman archives. They are threaded and easy to search. However, Nabble really wants to be a forum, not a mailing list archive. This has caused trouble over the years, with people wanting to subscribe/post/reply to the Nabble forum, which is not really connected to Mailman. This is irritating for them at best.<br clear="all">
<br>I just figured out how to fix this. I am attaching the description of how it was done. There is a page in the help desk wiki on Nabble. At some point my replacement should update that doc.<br><br>I'm going to take a peek at the GMOD Nabble archive and see if I can easily make the same changes there. If I can, I will do so.* I will let you know how it goes.<br>
<br>Cheers,<br><br>Dave C.<br><br>* The Galaxy and GMOD archives are structured differently. GMOD will either be much easier or much harder.<br><br><h1 id="NAML">NAML</h1>
<span class="anchor" id="line-11"></span><span class="anchor" id="line-12"></span><p class="line874">Nabble
markets itself as both a place for forums where you can post questions
and responses, and as an archive for existing lists. However, it really
wants to be a forum, and not an archive. The default behavior is to
include all sorts of stuff like "subscribe", "new topic", and "reply"
that we want to happen on the mailing list, not just on Nabble. <span class="anchor" id="line-13"></span><span class="anchor" id="line-14"></span></p><p class="line867"><a class="http" href="http://naml.nabble.com/">NAML</a>, the markup language used to control page layout at <a class="http" href="http://nabble.com/">Nabble</a>, allows you to override this default behavior. It was far easier to figure out than I expected. <span class="anchor" id="line-15"></span><span class="anchor" id="line-16"></span></p>
<p class="line867">
</p><h2 id="Navigating_and_Updating_NAML">Navigating and Updating NAML</h2>
<span class="anchor" id="line-17"></span><span class="anchor" id="line-18"></span><p class="line862">To update the markup for a page, you must first login as the admin of that list. For the Galaxy lists, the user is <strong><a class="mailto" href="mailto:outreach@galaxyproject.org">outreach@galaxyproject.org</a></strong> <span class="anchor" id="line-19"></span><span class="anchor" id="line-20"></span></p>
<p class="line862">To get into NAML, <em>click</em> on <strong>See how NAML generates this page</strong> at the bottom of any page. From there you can navigate either by <span class="anchor" id="line-21"></span></p><ol type="1">
<li>clicking on Macro names in the code, to explore how things are called, or <span class="anchor" id="line-22"></span></li><li>clicking on the cog near the top of the page and either searching for text or for a macro by name. <span class="anchor" id="line-23"></span><span class="anchor" id="line-24"></span></li>
</ol><p class="line874">The
directions on this page describe both methods. However, once you know
the name of the macro to change, it is easier just to go their directly.
<span class="anchor" id="line-25"></span><span class="anchor" id="line-26"></span></p><p class="line867">
</p><h2 id="Changes_Made">Changes Made</h2>
<span class="anchor" id="line-27"></span><span class="anchor" id="line-28"></span><p class="line867">
</p><h3 id="Remove_New_Topic_Links">Remove New Topic Links</h3>
<span class="anchor" id="line-29"></span><span class="anchor" id="line-30"></span><p class="line862">We don't allow people to create new topics. However, Nabble still displays a link that says <strong>New Topic</strong>. If you click on it, it tells you "You cannot post here" <span class="anchor" id="line-31"></span><span class="anchor" id="line-32"></span></p>
<p class="line867">
</p><h4 id="On_Forum_Landing_Page">On Forum Landing Page</h4>
<span class="anchor" id="line-33"></span><span class="anchor" id="line-34"></span><ol type="1"><li><p class="line891"><em>Click</em> on <strong>See how NAML generates this page</strong> <span class="anchor" id="line-35"></span></p>
</li><li><p class="line891"><em>Click</em> on <strong>view_standard_page</strong> <span class="anchor" id="line-36"></span></p></li><li><p class="line891"><em>Click</em> on <strong>Override this macro</strong> <span class="anchor" id="line-37"></span></p>
</li><li><p class="line891"><em>Delete</em> the line (about line 9) that says <strong><n.new_topic_action_link/></strong> <span class="anchor" id="line-38"></span></p></li><li><p class="line891"><em>Click</em> on <strong>Save Changes</strong> <span class="anchor" id="line-39"></span></p>
</li><li><p class="line862">Test it. The <strong>New Topic</strong> link should no longer appear. <span class="anchor" id="line-40"></span><span class="anchor" id="line-41"></span><span class="anchor" id="line-42"></span></p>
</li></ol><p class="line867">
</p><h3 id="Replace_Subscribe_Links">Replace Subscribe Links</h3>
<span class="anchor" id="line-43"></span><span class="anchor" id="line-44"></span><p class="line874">Nabble's
default subscribe links do a pseudo-subscribe where the user is not
actually subscribed in Mailman. This is evil. Instead replace those
links with links to the Mailman subscribe page. <span class="anchor" id="line-45"></span><span class="anchor" id="line-46"></span></p><p class="line867">
</p><h4 id="On_Forum_Landing_Page-1">On Forum Landing Page</h4>
<span class="anchor" id="line-47"></span><span class="anchor" id="line-48"></span><ol type="1"><li><p class="line891"><em>Click</em> on <strong>See how NAML generates this page</strong> <span class="anchor" id="line-49"></span></p>
</li><li><p class="line891"><em>Click</em> on <strong>view_standard_page</strong> <span class="anchor" id="line-50"></span></p></li><li><p class="line891"><em>Click</em> on <strong>options_action_menu</strong> <span class="anchor" id="line-51"></span></p>
</li><li><p class="line891"><em>Click</em> on <strong>app_dropdown</strong> <span class="anchor" id="line-52"></span></p></li><li><p class="line891"><em>Click</em> on <strong>menu_subscription</strong> <span class="anchor" id="line-53"></span></p>
</li><li><p class="line891"><em>Click</em> on <strong>subscribe_link</strong> <span class="anchor" id="line-54"></span></p></li><li><p class="line891"><em>Click</em> on <strong>Override this macro</strong> <span class="anchor" id="line-55"></span></p>
</li><li><p class="line891"><em>Replace</em> this line (line 2): <span class="anchor" id="line-56"></span></p><ul><li style="list-style-type:none"><p class="line891"><tt><a
href="[n.subscribe_path/]" class="[n.class/]" rel="nofollow"
title="[n.title/]"><n.default. to="[t]Subscribe via
email[/t]"><n.text/></n.default.></a></tt> <span class="anchor" id="line-57"></span></p></li></ul>with this line: <span class="anchor" id="line-58"></span><ul><li style="list-style-type:none"><p class="line891">
<tt><a
href="<a href="http://lists.bx.psu.edu/listinfo/galaxy-announce">http://lists.bx.psu.edu/listinfo/galaxy-announce</a>"
class="[n.class/]" rel="nofollow" title="[n.title/]"><n.default.
to="[t]Subscribe to
Galaxy-Announce[/t]"><n.text/></n.default.></a></tt> <span class="anchor" id="line-59"></span></p></li></ul></li><li><p class="line891"><em>Click</em> on <strong>Save Changes</strong> <span class="anchor" id="line-60"></span></p>
</li><li><p class="line862">Test it. The <strong>Options → Subscribe via email</strong> link should now be <strong>Options → Subscribe to Galaxy-Announce</strong> and should link to Mailman. <span class="anchor" id="line-61"></span><span class="anchor" id="line-62"></span></p>
</li></ol><p class="line867">
</p><h4 id="On_Other_Pages">On Other Pages</h4>
<span class="anchor" id="line-63"></span><span class="anchor" id="line-64"></span><p class="line862">Updating the <strong>subscribe_link</strong> macro above has the miraculous property of fixing the link everywhere. God bless those Nabble folk. <span class="anchor" id="line-65"></span><span class="anchor" id="line-66"></span></p>
<p class="line867">
</p><h3 id="Remove_Reply_links_on_thread_pages">Remove Reply links on thread pages</h3>
<span class="anchor" id="line-67"></span><span class="anchor" id="line-68"></span><ol type="1"><li><p class="line891"><em>Click</em> on <strong>See how NAML generates this page</strong> from any page <span class="anchor" id="line-69"></span></p>
</li><li><p class="line891"><em>Click</em> on the <strong>Cog Pulldown</strong> near the top of the page and <em>select</em> <strong>Search Macros</strong> <span class="anchor" id="line-70"></span></p></li><li><p class="line891">
<em>Enter</em> <tt>reply_link</tt> in the search box. <span class="anchor" id="line-71"></span></p></li><li><p class="line891"><em>Click</em> on <strong>reply_link</strong> and then <strong>Override this macro</strong> <span class="anchor" id="line-72"></span></p>
</li><li><p class="line891"><em>Delete</em> the body of the Macro leaving the start and finish lines. </p></li></ol><br><br>-- <br><a href="http://galaxyproject.org/" target="_blank">http://galaxyproject.org/</a><br><a href="http://getgalaxy.org/" target="_blank">http://getgalaxy.org/</a><br>
<a href="http://usegalaxy.org/" target="_blank">http://usegalaxy.org/</a><br><a href="http://galaxyproject.org/wiki/" target="_blank">http://galaxyproject.org/wiki/</a><br><br>