OpenSUSE-Medical/Wiki

From openSUSE

Background

The goal of this proposal is:

1. Make Medical-related content well-organized
2. Help Medical in openSUSE's Wiki be easily discoverable
3. Encourage participation in the openSUSE-Medical Project

Please take a moment and review the following proposal and offer your own suggestions. Are we missing something? Are there other pages in the Wiki already we should be linking to?

Layout Guidelines

• New pages related to "Medical" should be created as a subpage of /OpenSUSE-Medical/ (many examples above)
  • For example,

    http://en.opensuse.org/OpenSUSE-Medical/My_New_Page

• New (and already existing) pages should be marked with

  [[Category:Medical]]

  which will make them show up at Category:Medical.
• If pages are translated into other languages, please re-link!
  • For example: if you translate the english site "foo" into german, please create the following entry on the german site:

    [[en:foo]]

    and add the following entry on the original english page:

    [[de:foo]]

    .

Template for new sites

As a simple template for new openSUSE-Medical sites, use the following content:

[[Category:Medical]]
[[de:]]
__TOC__

-------insert your content here-------

Template for Application descriptions

To get an unique layout for the description of applications, we prefer to use the following template (XXX - name of the program):

Introduction

Getting Started

To install XXX issue the following command in a terminal as root:

zypper in XXX

This will grab the application and all its dependencies from the Internet, so you need to be connected to the Internet. After installing, you can run the program under the menu:

Applications -> Education -> XXX

Or press ALT+F2 on your desktop (or go to a terminal like gnome-terminal and konsole), type XXX, and press Enter.

Usage

Preferences

Shortcuts

There are some options accessible by pressing keyboard keys:

• Some Key - Some action

External Links

• [url Homepage]

Screenshots

{| style="border:2px dashed #b2cc7f; background:#f0f0f4;"
|-
| [[Image:Edu_XXX_ss_00.png|350px]] || [[Image:Edu_XXX_ss_01.png|350px]]
|-
| [[Image:Edu_XXX_ss_02.png|350px]] || [[Image:Edu_XXX_ss_03.png|350px]]
|}

[[Category:Medical]]

[[de:Name of this wiki page in German]]
[[ru:Name of this wiki page in Russian]]

To create a new description for an application, just login and enter the URL http://en.opensuse.org/<packagename>. Now you can create a new page when you click on the "edit" link. Paste the above template in the new textfield and fill it out.

• Category:<RPM-GROUP> => Use the RPM group of the package, so we get it sorted under its normal Category. Use ":" instead of the "/" in the RPM group field. To find out the RPM group of an already installed rpm via commandline, just enter the command

rpm -q --qf "%{GROUP}\n" <packagename>

• Package-description => Enter a short description of the package here. If you like, you can use the description from the original RPM:

rpm -q --qf "%{DESCRIPTION}\n" <packagename>

• The "Infobox Software" creates a short summary including links to webpin - so a user can search for the package for his distribution online
  • name => the name of the package
  • developer => the name of the main developer (not packager)
  • image => needs two URLs: first one is normally a link to the main website, the seconds one a link to the logo in *.png, *.gif or *.jpg format
  • description => a short description of the package, you can use the RPM summary here.

rpm -q --qf "%{SUMMARY}\n" <packagename>

• • license => the license of the package:

rpm -q --qf "%{LICENSE}\n" <packagename>

• • website => the main website of the package:

rpm -q --qf "%{URL}\n" <packagename>

Installing and configuration should lead the user to a well running application. As we describe already packaged software here, the installation section normally just contains something like "install the package with your favorite package manager on your system". But sometimes it's more difficult to get the application running on your system...

The most important part should be the "configuring" section: where can a user find the config file(s) and what he has to do to get it up and running as he wants.

See also should provide some links to other applications available in the education repository. So this should be innerwiki links.

In the footer, add tranlsation links to other openSUSE wikis. The example above show how to add the pull down menu "in other languages" for the german (de) wiki.

<center>{{Info|This category contains Medical applications for doctor's practice and clinical use.

<br>
If we miss some application here, have a look at [[Special:Uncategorizedpages|the uncategorized pages]] or get an [http://en.opensuse.org/Category:Medical overview]. 

If you didn't found your application there, please add it to our [[Wishlist_Medical|Wishlist]].
}}

{{browse}}</center>

[[Category: Medical]]
[[Category: Applications]]

Meetings

• Please acknowledge the meeting guidelines
• All meeting information should be collected under OpenSUSE-Medical/Meetings
• Individual meetings are at OpenSUSE-Medical/Meetings/YYYYMMDD
• OpenSUSE-Medical/Meetings/Current redirects to the next meeting
• Links to past meetings should be added to OpenSUSE-Medical/Meetings/Archives and Meetings/Archive
• Meetings/Medical_Meeting_YYYY-MM-DD redirects to Education/Meetings/YYYYMMDD
• Meetings/Medical_Meeting_YYYY-MM-DD/transcript redirects to Education/Meetings/YYYYMMDD/transcript

Roadmap

More targets for openSUSE-Education related wiki pages inkluding a first estimated time frame can be found at the Wiki-Roadmap.