VDR Wiki:Conventions: Difference between revisions
No edit summary |
m (Reverted edit of 150.164.52.1, changed back to last version by Monroe) |
||
| (6 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
==Article== |
|||
Internet as the transmission medium for telephone calls. For users who have free, or fixed-price Internet access, Internet telephony software essentially provides free telephone calls anywhere in the world. To date, however, Internet telephony does not offer the same quality of telephone service as direct telephone connections. |
|||
There are many Internet telephony applications available. Some, like CoolTalk and NetMeeting, come bundled with popular Web browsers. Others are stand-alone products. Internet telephony products are sometimes called IP telephony, Voice over the Internet or Voice over IP products. |
|||
===Naming schemes=== |
|||
* [http://www.voip-guide.org/ voip] |
|||
* [http://www.voip-guide.org/voip.php voip] |
|||
====General==== |
|||
* [http://www.voip-guide.org/voip-services.php VoIP Services] |
|||
* [http://www.voip-guide.org/voip-provider.php VoIP Provider] |
|||
====Plugins==== |
|||
* [http://www.softwarematrix.org/ Software] |
|||
Titles of articles about plugins are written lowercase. The name consists |
|||
* [http://www.softwarematrix.org/software.php Software] |
|||
of the plugin name and an appended ''-plugin'', so |
|||
* [http://www.softwarematrix.org/system-software.php System Software] |
|||
name-plugin |
|||
* [http://www.softwarematrix.org/anti-virus-software.php Anti-virus software] |
|||
* [http://www.wifi-planet.org/ WiFi] |
|||
====Patches==== |
|||
* [http://www.wifi-planet.org/wifi.php WiFi] |
|||
Titles of articles about patches are written lowercase. The name consists |
|||
* [http://www.wifi-planet.org/wifi-hotspots.php WiFi Hotspots] |
|||
of the patch name and an appended ''-patch'', so |
|||
* [http://www.wifi-planet.org/wi-fi.php WiFi] |
|||
name-patch |
|||
* [http://www.gpsplanet.org GPS] |
|||
* [http://www.gpsplanet.org/garmin-gps.php Garmin GPS] |
|||
====Distribution specific articles==== |
|||
* [http://www.gpsplanet.org/megellan-gps.php Magellan GPS] |
|||
The majority of articles in this wiki should general enough to apply to |
|||
* [http://www.conferencing-guide.com/conferencing.php conferencing] |
|||
all common distributions. Nontheless some article there also exists some |
|||
* [http://www.conferencing-guide.com/video-conferencing.php Video Conferencing] |
|||
articles that describe distribution specific characteristics. To avoid a |
|||
* [http://www.callcenter-guide.com/predictive-dialers.php Predictive Dialers] |
|||
collision with with other articles, their name should start with the name |
|||
* [http://www.callcenter-guide.com/call-center.php Call Center] |
|||
of the distribution in upper case letters. E.g. |
|||
* [http://www.callcenter-guide.com/call-center-services.php Call Center Services] |
|||
DISTRIBUTION article name |
|||
* [http://www.techomatic.com/predictive-dialers.php Predictive Dialers] |
|||
* [http://www.techomatic.com/crm.php Crm] |
|||
===Structure=== |
|||
* [http://www.techomatic.com/dialers.php Dialers] |
|||
* [http://www.techomatic.com/call-center.php Call Center] |
|||
====General==== |
|||
* [http://www.techomatic.com/voip.php Voip] |
|||
====Plugins==== |
|||
An article about a plugin has to include the following minimal structure. There also exist a template for this. To use it just place ''<nowiki>{{subst:Article (plugin)}}</nowiki>'' in the otherwise empty article, save it and edit again. |
|||
<pre> |
|||
==Description== |
|||
[[Image:plugin-name.jpg|thumb|Description]] |
|||
If the link to the UPLOADED image is placed in the above form before |
|||
the text, it will be shown right aligned besides the text. This looks |
|||
nice and is space saving. |
|||
==Hardware requirements== |
|||
* Requirement 1 |
|||
* Requirement 2 |
|||
* ... |
|||
==Software requirements== |
|||
* Requirement 1 |
|||
* Requirement 2 |
|||
* ... |
|||
==Installation== |
|||
See [[plugin installation]]. |
|||
==Problems== |
|||
==Links== |
|||
{| |
|||
| [1] |
|||
| http:// |
|||
| Plugin homepage |
|||
|} |
|||
[[Category:Plugins]] |
|||
<!-- Link to the german VDR Wiki --> |
|||
[[de:german title]] |
|||
</pre> |
|||
For articles where more sections are necessary, here is an example. There also exist a template for this. To use it just place ''<nowiki>{{subst:Article (plugin ext)}}</nowiki>'' in the otherwise empty article, save it and edit again. |
|||
<pre> |
|||
==Description== |
|||
[[Image:plugin-name.jpg|thumb|Description]] |
|||
If the link to the UPLOADED image is placed in the above form before |
|||
the text, it will be shown right aligned besides the text. This looks nice |
|||
and is space saving. |
|||
===Handling=== |
|||
A list of key with description, used by the plugin. |
|||
{| border=1 cellpadding=2 cellspacing=0 |
|||
|- bgcolor=#efdead |
|||
!Key |
|||
!Description |
|||
|- |
|||
!bgcolor=#efefef| Right || Fast forward (5 sec.) |
|||
|- |
|||
!bgcolor=#efefef| Left || Fast backward (5 sec.) |
|||
|- |
|||
!bgcolor=#efefef| Up || Next song |
|||
|} |
|||
==Hardware requirements== |
|||
* Requirement 1 |
|||
* Requirement 2 |
|||
* ... |
|||
==Software requirements== |
|||
* Requirement 1 |
|||
* Requirement 2 |
|||
* ... |
|||
==Installation== |
|||
If the description of [[plugin installation]] is not appropiate or some |
|||
subsection are necessary, use these |
|||
===Options=== |
|||
Compile or '''Makefile''' options shouldgo here. |
|||
{| border=1 cellpadding=2 cellspacing=0 |
|||
|- bgcolor=#efdead |
|||
!Option |
|||
!Description |
|||
|- |
|||
| SOME_OPTION=1 || Description of the option |
|||
|} |
|||
===Patches=== |
|||
Information about Patches here. |
|||
==Configuration== |
|||
Information about settings in system files (like '''/etc/fstab''') or |
|||
in configuration files of the plugin (like '''mp3sources.conf'''). |
|||
===Parameter=== |
|||
The commandline parameters of the plugins |
|||
{| border=1 cellpadding=2 cellspacing=0 |
|||
|- bgcolor=#efdead |
|||
!Parameter (short) |
|||
!Parameter (long) |
|||
!Description |
|||
|- |
|||
| -a ABC || --aaa=ABC || some Parameter |
|||
|- |
|||
| -b || --bbb || another Parameter |
|||
|} |
|||
==Problems== |
|||
==CVS== |
|||
cvs ... login |
|||
cvs ... co ... |
|||
==Links== |
|||
{| |
|||
| [1] |
|||
| http:// |
|||
| Plugin homepage |
|||
|} |
|||
[[Category:Plugins]] |
|||
<!-- Link to the german VDR Wiki --> |
|||
[[de:german title]] |
|||
</pre> |
|||
Those points in the extended example that are not necessary, can be |
|||
omitted. Section of the basic example are left empty (like ==Problems== above). |
|||
====Patches==== |
|||
The article stucture is the same as for the plugins, only the image names and the categories has to be adapted. There also exist a template for this. To use it just place ''<nowiki>{{subst:Article |
|||
(patch)}}</nowiki>'' in the otherwise empty article, save it and edit again. |
|||
<pre> |
|||
[[Image:name-patch.jpg]] |
|||
[[Category:Patches]] |
|||
</pre> |
|||
===Formatting rules/style guide=== |
|||
====Version numbers==== |
|||
Nearly every program archive has a version number in it's name. Since in most cases several versions of a program are possible, a placeholder for the version number should be used. |
|||
mediawiki-<VERSION>.tar.gz |
|||
This placeholder seems to be the most general possible. |
|||
====Directories==== |
|||
Directory names in the text should be highlighted with italics, like '''/usr/local/bin'''. This should improve readability. |
|||
<nowiki>[...] '''/usr/local/bin''' [...]</nowiki> |
|||
==Images== |
|||
===Naming schemes=== |
|||
====General==== |
|||
A screenshot or image makes a text look more nicely and is a good visible discription. Images should alway be uplouded. Only uplouded images ensure accessability and resizeability. Also the copyright issue is a reason againt external linking. |
|||
Screenshots of programs should be named like the program and possibly a description in brackets like |
|||
programname(screen name).jpg |
|||
where screen name can be ''setup'', ''main'',... |
|||
For images of hardware and other objects, one should choose a good descriptive name, e.g. for DVB cards include the revision number. |
|||
====Plugins==== |
|||
Every plugin should have one or more screenshots. For plugins the same naming rules as above apply. |
|||
name-plugin.jpg |
|||
name-plugin(screen name).jpg |
|||
where screen name can be ''setup'', ''main'',... |
|||
====Patches==== |
|||
If a patch visually changes the behaviour of VDR, a screenshot would be nice, too. For patches the same naming rules as above apply. |
|||
name-patch.jpg |
|||
name-patch(screen name).jpg |
|||
where screen name can be ''setup'', ''main'',... |
|||
===Format=== |
|||
====General==== |
|||
For photographs and screenshots, the JPEG format fits best. For electronic circuits the PNG format is better. |
|||
A resolution of 800x600 for program screenshot and other images should be enough. 768x576 for shots of TV screen. |
|||
Please optimize the file size of the image before uploading it. HOWTOS for this can be found in the internet for varies programs. |
|||
To make screenshots of VDR and his Plugins, use |
|||
svdrpsend.pl grab "/video/"$(date --iso-8601=seconds)".jpg" jpeg 50 |
|||
==Categories== |
|||
Categories are a practical way give the article masses a structure. But one should think twice, wether a new category is necessary or not. |
|||
One can create categories and sub-categories and one or more of them could be assigned to an article. |
|||
Es gibt dabei nicht nur die Möglichkeit einen Artikel einer Kategorie zuzuordnen man kann ihn auch mehreren Kategorien und/oder Unter-Kategorien zuordnen. |
|||
'''''This is only a suggestion at the moment some don't even exist!''''' |
|||
'''General''' |
|||
* [[:Category:Software]] |
|||
** [[:Category:Plugins]] |
|||
** [[:Category:Patches]] |
|||
* [[:Category:Hardware]] |
|||
'''VDR Wiki''' |
|||
* [[:Category:Help]] |
|||
[[Category:Help]] |
|||
Latest revision as of 11:45, 16 December 2005
Article
Naming schemes
General
Plugins
Titles of articles about plugins are written lowercase. The name consists of the plugin name and an appended -plugin, so
name-plugin
Patches
Titles of articles about patches are written lowercase. The name consists of the patch name and an appended -patch, so
name-patch
Distribution specific articles
The majority of articles in this wiki should general enough to apply to all common distributions. Nontheless some article there also exists some articles that describe distribution specific characteristics. To avoid a collision with with other articles, their name should start with the name of the distribution in upper case letters. E.g.
DISTRIBUTION article name
Structure
General
Plugins
An article about a plugin has to include the following minimal structure. There also exist a template for this. To use it just place {{subst:Article (plugin)}} in the otherwise empty article, save it and edit again.
==Description==
[[Image:plugin-name.jpg|thumb|Description]]
If the link to the UPLOADED image is placed in the above form before
the text, it will be shown right aligned besides the text. This looks
nice and is space saving.
==Hardware requirements==
* Requirement 1
* Requirement 2
* ...
==Software requirements==
* Requirement 1
* Requirement 2
* ...
==Installation==
See [[plugin installation]].
==Problems==
==Links==
{|
| [1]
| http://
| Plugin homepage
|}
[[Category:Plugins]]
<!-- Link to the german VDR Wiki -->
[[de:german title]]
For articles where more sections are necessary, here is an example. There also exist a template for this. To use it just place {{subst:Article (plugin ext)}} in the otherwise empty article, save it and edit again.
==Description==
[[Image:plugin-name.jpg|thumb|Description]]
If the link to the UPLOADED image is placed in the above form before
the text, it will be shown right aligned besides the text. This looks nice
and is space saving.
===Handling===
A list of key with description, used by the plugin.
{| border=1 cellpadding=2 cellspacing=0
|- bgcolor=#efdead
!Key
!Description
|-
!bgcolor=#efefef| Right || Fast forward (5 sec.)
|-
!bgcolor=#efefef| Left || Fast backward (5 sec.)
|-
!bgcolor=#efefef| Up || Next song
|}
==Hardware requirements==
* Requirement 1
* Requirement 2
* ...
==Software requirements==
* Requirement 1
* Requirement 2
* ...
==Installation==
If the description of [[plugin installation]] is not appropiate or some
subsection are necessary, use these
===Options===
Compile or '''Makefile''' options shouldgo here.
{| border=1 cellpadding=2 cellspacing=0
|- bgcolor=#efdead
!Option
!Description
|-
| SOME_OPTION=1 || Description of the option
|}
===Patches===
Information about Patches here.
==Configuration==
Information about settings in system files (like '''/etc/fstab''') or
in configuration files of the plugin (like '''mp3sources.conf''').
===Parameter===
The commandline parameters of the plugins
{| border=1 cellpadding=2 cellspacing=0
|- bgcolor=#efdead
!Parameter (short)
!Parameter (long)
!Description
|-
| -a ABC || --aaa=ABC || some Parameter
|-
| -b || --bbb || another Parameter
|}
==Problems==
==CVS==
cvs ... login
cvs ... co ...
==Links==
{|
| [1]
| http://
| Plugin homepage
|}
[[Category:Plugins]]
<!-- Link to the german VDR Wiki -->
[[de:german title]]
Those points in the extended example that are not necessary, can be omitted. Section of the basic example are left empty (like ==Problems== above).
Patches
The article stucture is the same as for the plugins, only the image names and the categories has to be adapted. There also exist a template for this. To use it just place {{subst:Article (patch)}} in the otherwise empty article, save it and edit again.
[[Image:name-patch.jpg]] [[Category:Patches]]
Formatting rules/style guide
Version numbers
Nearly every program archive has a version number in it's name. Since in most cases several versions of a program are possible, a placeholder for the version number should be used.
mediawiki-<VERSION>.tar.gz
This placeholder seems to be the most general possible.
Directories
Directory names in the text should be highlighted with italics, like /usr/local/bin. This should improve readability.
[...] '''/usr/local/bin''' [...]
Images
Naming schemes
General
A screenshot or image makes a text look more nicely and is a good visible discription. Images should alway be uplouded. Only uplouded images ensure accessability and resizeability. Also the copyright issue is a reason againt external linking.
Screenshots of programs should be named like the program and possibly a description in brackets like
programname(screen name).jpg
where screen name can be setup, main,...
For images of hardware and other objects, one should choose a good descriptive name, e.g. for DVB cards include the revision number.
Plugins
Every plugin should have one or more screenshots. For plugins the same naming rules as above apply.
name-plugin.jpg name-plugin(screen name).jpg
where screen name can be setup, main,...
Patches
If a patch visually changes the behaviour of VDR, a screenshot would be nice, too. For patches the same naming rules as above apply.
name-patch.jpg name-patch(screen name).jpg
where screen name can be setup, main,...
Format
General
For photographs and screenshots, the JPEG format fits best. For electronic circuits the PNG format is better.
A resolution of 800x600 for program screenshot and other images should be enough. 768x576 for shots of TV screen. Please optimize the file size of the image before uploading it. HOWTOS for this can be found in the internet for varies programs.
To make screenshots of VDR and his Plugins, use
svdrpsend.pl grab "/video/"$(date --iso-8601=seconds)".jpg" jpeg 50
Categories
Categories are a practical way give the article masses a structure. But one should think twice, wether a new category is necessary or not.
One can create categories and sub-categories and one or more of them could be assigned to an article. Es gibt dabei nicht nur die Möglichkeit einen Artikel einer Kategorie zuzuordnen man kann ihn auch mehreren Kategorien und/oder Unter-Kategorien zuordnen.
This is only a suggestion at the moment some don't even exist!
General
VDR Wiki