emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Hyperlinked Tag table in org-publish HTML export
@ 2008-07-30 14:03 Rick Moynihan
       [not found] ` <87k5f3uwxf.fsf@kassiopeya.MSHEIMNETZ>
  0 siblings, 1 reply; 2+ messages in thread
From: Rick Moynihan @ 2008-07-30 14:03 UTC (permalink / raw)
  To: emacs-orgmode

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.

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: Hyperlinked Tag table in org-publish HTML export
       [not found] ` <87k5f3uwxf.fsf@kassiopeya.MSHEIMNETZ>
@ 2008-08-01 11:45   ` Rick Moynihan
  0 siblings, 0 replies; 2+ messages in thread
From: Rick Moynihan @ 2008-08-01 11:45 UTC (permalink / raw)
  To: Sebastian Rose; +Cc: emacs-orgmode

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.

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2008-08-01 11:45 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2008-07-30 14:03 Hyperlinked Tag table in org-publish HTML export Rick Moynihan
     [not found] ` <87k5f3uwxf.fsf@kassiopeya.MSHEIMNETZ>
2008-08-01 11:45   ` Rick Moynihan

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).