emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Custom links
@ 2008-10-09  0:49 Sebastian Rose
  0 siblings, 0 replies; only message in thread
From: Sebastian Rose @ 2008-10-09  0:49 UTC (permalink / raw)
  To: [emacs-orgmode]

[-- Attachment #1: Type: text/plain, Size: 1971 bytes --]

Hi,


there where questions about custom links here from time to time.
I thought I'd share my way of displaying man pages, info pages
and such.


This is how I set up my custom links:


(setq org-link-abbrev-alist
   '(("man"     . "http://localhost/man.php?q=man&what=%s")
     ("info"    . "http://localhost/man.php?q=info&what=%s")
     ("help"    . "http://localhost/man.php?q=help&what=%s")
     ("apropos" . "http://localhost/man.php?q=apropos&what=%s")
      ;;; etc. several more...
     ))

As you can see here, I prefer to BROWSE man pages.
I hate to clutter my emacs session with buffers like *man*.

The "http://localhost/devel/man.php" is attached to this mail. It's not
the version I use localy (that is included in a knowledge base app I
wrote), but it's just working that way.

The man.php does display links in Org-files like

[[man:man][How to use the man command]]
[[man:man 7][How to write manpages]]
[[help:man][man --help]]
[[info:man][Read about man in info]] needs info2html or info2www.
[[apropos:man][man -k -- find man pages refering to man]]


man.php also turns the names of man pages in the 'SEE ALSO' section
into hyperlinks. Same is true for the names of man pages listed in the
apropos' output. This way, you can BROWSE YOUR MAN PAGES.

A big advantage is the use of tabs in a web browser like opera or
firefox.

The script is easy to set up if you have a webserver running locally. 
It's not meant for a public installation, where you don't want to allow
scripts to execute shell commands. Having 'man' installed, a webserver
is just an 'apt-get install apache2 php5' or 'rpm -I apache2 php5'.
You might also need to install one or two packages from the roff
family, to create the HTML output.

I could not live without a webserver and database installed. Can you?

The setup is just as simple. Put man.php in a directory under your
localhost's web root and adjust the three values in the SETUP section.

Happy browsing,

  - Sebastian


[-- Attachment #2: man.php --]
[-- Type: application/x-httpd-php, Size: 6279 bytes --]

[-- Attachment #3: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2008-10-09  0:48 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-10-09  0:49 Custom links Sebastian Rose

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).