emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Sebastian Rose <sebastian_rose@gmx.de>
To: "[emacs-orgmode]" <emacs-orgmode@gnu.org>
Subject: Custom links
Date: Thu, 09 Oct 2008 02:49:09 +0200	[thread overview]
Message-ID: <48ED5505.4060807@gmx.de> (raw)

[-- 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

                 reply	other threads:[~2008-10-09  0:48 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=48ED5505.4060807@gmx.de \
    --to=sebastian_rose@gmx.de \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).