[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