Hyperlinked Tag table in org-publish HTML export

Hyperlinked Tag table in org-publish HTML export

[Rick Moynihan]

Hi all,

Well I've been continuing my usage of org-mode, and have been using it 
for sometime as a lightweight bug tracker for documenting bugs and 
associated code-snippets/error-reports in small software projects.

Recently I wanted to make this document viewable for others, and so 
published it with org-export-as-html.  Anyway, I'm delighted with the 
output; particularly regarding the fontifying of code-snippets, but 
there is an improvement I'd like to make in my output:

I currently document bugs roughly like this:

* ProjectX bugs
** BUG project crashes on network failure :2.0:NETWORK:UI:
** BUGREPORT error thrown on data entry   :DB:
** FIXED compiler warnings                :1.0:BUILD:

* ProjectX Improvements
** FEATUREREQUEST Add a new button to UI   :2.1:UI:
** FEATUREREQUEST Add email support        :2.3:UI:EMAIL:EXP:
** FEATUREREQUEST Support X,Y,Z            :3.0:DB:TRUNK:EXP:

You'll notice that I use tags to categorise features/bugs and to 
prioritise them into versions of the software.  I also use these tags to 
indicate which branch features/bugs might be best put into.  Sometimes 
these changes are required to be deployed into several branches so 
tagging like this is flexible and works well.

However the problem is that, in the exported HTML the tags are not 
listed in a useful way.  It would be great if org could generate a table 
of contents organised by tag.  To allow easier navigation Tags on 
outlines/headings would then be links back to the tag table, and links 
in the tag-table would link to the headings like they do already with 
the TOC.

Thinking about it, would org-info.js do this?

Thanks again!


R.

Re: Hyperlinked Tag table in org-publish HTML export

[Rick Moynihan]

Sebastian Rose wrote:
 > Hi Rick,
 >
 >
 > I don't seem to understand your aim precisely. How should this
 > navigation look like in HTML?
 >
 > If we had a 'tag cloud' or a tag index - where should the link 'TAG'
 > point to? There could be multiple headlines in the file using that tag
 > 'TAG'.

Sorry, I should have been clearer... What I was meaning was a table of 
contents but organised by tags (perhaps in alphabetical order) e.g.

1.0
   FIXED Compiler warnings
2.0
   BUG project crashes on network failure
2.1
   FEATUREREQUEST Add a new button to UI
2.3
   FEATUREREQUEST Add email support
3.0
   FEATUREREQUEST Support X,Y,Z
BUILD
   FIXED compiler warnings
DB
   BUGREPORT error thrown on data entry
   FEATUREREQUEST Support X,Y,Z
EMAIL
   FEATUREREQUEST Add email support
EXP
   FEATUREREQUEST Add email support
   FEATUREREQUEST Support X,Y,Z

etc...

Then each heading would link back to the tag in the table of contents, 
so you could reasonably (2 clicks) easily jump to other items with that 
same tag.  But I have just switched to your org-info-js, which is a 
great piece of work!  And I think your idea of somehow dynamically 
assembling a list of outlines that have a tag, would be ideal!


 > Did you realise the 'o' shortcut? This is in since two month or so.
 > http://orgmode.org/worg/code/org-info-js/
 > shows the current version.
 >
 > You may press 'o' and input a search string. The page changes to plain
 > view mode, folds all the sections, and unfolds those containig the
 > searchstring (caseinsensitive). The matches are highlighted.
 >
 > use 'SHIFT-s' and 'SHIFT-r' to traverse all the (sub)sections with
 > matches. These keys will still work, after doing somthing else again
 > (change the view mode, follow a link etc.).
 >
 > Occur and search ('s') use the same searchstring.

Yes, I've seen this and it's similar to what I regularly do with firefox 
and type ahead find.  Very nice, but it doesn't quite seem to be the 
same as a being able to easily navigate around tags.... Am I missing 
something?

 > Have fun,

I already have been, and thanks again for org-info-js!

R.