[announcement] apt links on the wiki

Andrew Sayers andrew-bugs.launchpad.net at pileofstuff.org
Fri Apr 10 10:30:35 UTC 2009


I can confirm that apturl isn't installed on a Kubuntu Intrepid box I 
have access to.  How about if we uploaded a small "package" icon (like 
Synaptic's icon), then used markup of the form:

{{{
To frobnicate your computer, install 
[[InstallingSoftware#installing-a-package|{{package-icon.png}}]] 
[[apt:foo|foo]]
}}}

Which would be displayed as:

{{{
To frobnicate your computer, install []_foo_
}}}

That would be less jarring (because the icon doesn't interrupt the flow 
of text), without getting rid of the link altogether.  It would also 
help with how to use apt URLs in text of the form:

{{{
To use frobnicate a computer, you need a foo client, such as:

* gfoo, the GNOME foo client
* kfoo, the KDE foo client
* xfoo, the generic foo client
* _foo32_ also exists for Windows
* there's an _ifoo_ client for Mac
}}}

An example of that sort of text is in this section:
https://help.ubuntu.com/community/VNC#VNC%20Clients, where
I'm currently using a solution like this:

{{{
To use frobnicate a computer, you need a foo client, such as:

* gfoo, the GNOME foo client (_click here to install gfoo_)
* kfoo, the KDE foo client (_click here to install kfoo_)
* xfoo, the generic foo client (_click here to install xfoo_)
* _foo32_ also exists for Windows
* there's an _ifoo_ client for Mac
}}}

That makes lines much longer though, and isn't much fun to read.  With 
an icon, I could write:

{{{
To use frobnicate a computer, you need a foo client, such as:

* []_gfoo_, the GNOME foo client
* []_kfoo_, the KDE foo client
* []_xfoo_, the generic foo client
* _foo32_ also exists for Windows
* there's an _ifoo_ client for Mac
}}}

	- Andrew




More information about the ubuntu-doc mailing list