Difference between revisions of "Form:Entry"

From Free Software Directory
Jump to: navigation, search
(Undo revision 72740 by David Hedlund (talk) -- every future edit will remove license names)
(Tag: Undo)
(101 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
<noinclude>
 
<noinclude>
Before submitting a new entry to the Free Software Directory, please make sure that entry does not already exist.  
+
'''Before adding a new entry to the Free Software Directory (FSD), please make sure that entry does not already exist by first using the ''Search'' box.'''
 +
 
 +
Programs added to the FSD must be useful free software and it must run on a completely free OS such as GNU/Linux. If the software runs on non-free operating system, then it must work as well or better on the completely free operating system as it does on the other operating systems.
 +
 
 +
To add a new entry, please enter the name of the program below. Please note that after submitting a new entry, your page will not be public until it has been reviewed and approved and published by administrators. However, you can continue to make edits to the page with your new entry on it after you submit it and before it has been approved for publication -- just click the edit button on the page after it is created.
 +
 
 +
The text you use here will be the end of the URL for that project page, so make sure that the text is typeable ASCII (A-Z, a-z, 0-9 and spaces), has no awkward symbols, ideally no accents, and uses the spacing and capitalization that the project uses. The idea is that people should be able to type it easily, regardless of language. Also, the shorter name is best, when multiple are available.
 +
{{#forminput:form=Entry|button text=Add an entry}}
 +
 
 +
 
 +
 
  
To submit a new entry, please enter the name of the program below.
 
{{#forminput:form=Entry|button text=Submit an entry}}
 
 
</noinclude><includeonly>
 
</noinclude><includeonly>
 
=1. General info =
 
=1. General info =
This form contains eight tabs. Please fill out as much information as you can before saving. The save button appears at the bottom of the 8th tab.  
+
This form contains 9 tabs. Please include the license and other basic information. The '''Save''' button appears on the '''last (9th) tab'''.  
  
 
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
 
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
 
{{{for template|Entry|strict}}}
 
{{{for template|Entry|strict}}}
 +
<div style="width:500">
 
{| class="formtable"
 
{| class="formtable"
! Name (required):
+
 
 +
! Name <span style="color:#00b">(required)</span>: {{#info:Choosing the name for which the program is most commonly known is preferred. This can be different and/or longer than the page name if necessary. }}
 
| {{{field|Name|mandatory}}}
 
| {{{field|Name|mandatory}}}
 
|-
 
|-
! Short description (required):
+
 
 +
! Short description <span style="color:#00b">(required)</span>: {{#info:Should begin with a capital but not end with a period. Try to stay under 12 words.}}
 
| {{{field|Short description|mandatory}}}
 
| {{{field|Short description|mandatory}}}
 
|-
 
|-
! Full description (required):
+
 
 +
! Full description <span style="color:#00b">(required)</span>: {{#info:Please write a short summary of what the package does or is used for. [https://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] can be used. It shouldn't include licensing information or supported operating systems – categories will do that instead. We recommend writing your own original description. Also, remember that some there are a number of [http://www.gnu.org/philosophy/words-to-avoid.html expressions that we recommend avoiding].}}
 
| {{{field|Full description|mandatory}}}
 
| {{{field|Full description|mandatory}}}
 
|-
 
|-
! Homepage URL (required):
+
 
| {{{field|Homepage URL|mandatory}}}
+
! Screenshot 1:
 +
| {{{field|Screenshot 1|input type=text|uploadable|property=Screenshot 1|size=60}}}
 +
|-
 +
 
 +
! Screenshot 2:
 +
| {{{field|Screenshot 2|input type=text|uploadable|property=Screenshot 2|size=60}}}
 
|-
 
|-
! Is GNU:
+
 
| {{{field|Is GNU|input type=checkbox}}}
+
! Screenshot 3:
 +
| {{{field|Screenshot 3|input type=text|uploadable|property=Screenshot 3|size=60}}}
 
|-
 
|-
! User level:
+
 
| {{{field|User level|input type=radiobutton}}}
+
! Homepage URL <span style="color:#00b">(required)</span>:  
 +
| {{{field|Homepage URL|mandatory|size=60}}}
 
|-
 
|-
! Component programs:
+
 
| {{{field|Component programs|input type=text with autocomplete}}}
+
! Is High Priority Project:
 +
{{#info:[https://www.fsf.org/campaigns/priority-projects/ High Priority Free Software Projects by the Free Software Foundation]}}
 +
| {{{field|Is High Priority Project|input type=checkbox}}}
 
|-
 
|-
! VCS checkout command:
+
 
 +
! VCS checkout command: {{#info:The command should include <code>git clone</code>, <code>svn co</code> or anything relevant to the VCS used; if several repositories are used, separate the commands with ; (semicolon).}}
 
| {{{field|VCS checkout command}}}
 
| {{{field|VCS checkout command}}}
 
|-
 
|-
! Computer languages:
+
 
| {{{field|Computer languages}}}
+
! Computer languages:  
 +
|{{{field|Computer languages}}}
 
|-
 
|-
! Documentation note:
+
 
| {{{field|Documentation note}}}
+
! Documentation note: {{#info:[https://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] can be used.}}
 +
|{{{field|Documentation note}}}
 
|-
 
|-
! Paid support:
+
 
| {{{field|Paid support}}}
+
! Decommissioned/Obsolete:
 +
|{{{field|Decommissioned or Obsolete|input type=checkbox|show on select=decommissioneddiv}}}
 +
<div id="decommissioneddiv">
 +
{| class="formtable"
 +
! Details:  
 +
| {{{field|Decommissioned details|input type=textarea}}}
 
|-
 
|-
! IRC help:
+
! Replaced by: {{#info:URL of the page or name of package ( as "<nowiki>[[PKGNAME]]</nowiki>") which replaces current package.}}
| {{{field|IRC help}}}
+
| {{{field|Replaced by|input type=text|size=60}}}
 +
|}
 +
</div>
 
|-
 
|-
! IRC general:
+
 
| {{{field|IRC general}}}
+
! Donate:  
 +
|{{{field|Donate}}}
 
|-
 
|-
! IRC development:
+
 
| {{{field|IRC development}}}
+
! Microblog URL:  
 +
|{{{field|Microblog}}}
 
|-
 
|-
! Related projects:
+
 
 +
! IRC help: {{#info:Should be in the form of an <code>irc://</code> link, for use with IRC clients. Do not put the same channel as IRC general. The “real” freenode address is <code>chat.freenode.net</code>, all others are redirects.}}
 +
| {{{field|IRC help|size=60}}}
 +
|-
 +
 
 +
! IRC general: {{#info:Should be in the form of an <code>irc://</code> link, for use with IRC clients. If there is only one channel, write it here. The “real” freenode address is <code>chat.freenode.net</code>, all others are redirects.}}
 +
| {{{field|IRC general|size=60}}}
 +
|-
 +
 
 +
! IRC development: {{#info:Should be in the form of an <code>irc://</code> link, for use with IRC clients. Do not put the same channel as IRC general. The “real” freenode address is <code>chat.freenode.net</code>, all others are redirects.}}
 +
| {{{field|IRC development|size=60}}}
 +
|-
 +
 
 +
! Related projects: {{#info:Write closely related projects here, separated by commas and a space. Names are case-sensitive, except for the first letter. You may add non-existing entries.}}
 
| {{{field|Related projects}}}
 
| {{{field|Related projects}}}
 
|-
 
|-
! Keywords:
+
 
 +
! Keywords: {{#info:Separate keywords by commas and a space.}}
 
| {{{field|Keywords}}}
 
| {{{field|Keywords}}}
 
|-
 
|-
! Version identifier:
+
 
 +
! Version identifier:  
 
| {{{field|Version identifier}}}
 
| {{{field|Version identifier}}}
 
|-
 
|-
! Version date:
+
 
| {{{field|Version date}}}
+
! Version date:  
 +
| {{{field|Version date|input type=datepicker|date format=yy-mm-dd}}}
 
|-
 
|-
! Version status:
+
 
 +
! Version status: {{#info:If unsure, set to “stable” or see more details in the [[Free_Software_Directory:Participate#Guidelines for choosing Version Status of an entry|participation guide]].}}
 
| {{{field|Version status}}}
 
| {{{field|Version status}}}
 
|-
 
|-
! Version download:
+
 
| {{{field|Version download}}}
+
! Version download:  
 +
| {{{field|Version download|size=60}}}
 
|-
 
|-
! Version comment:
+
 
 +
! Version comment:
 
| {{{field|Version comment}}}
 
| {{{field|Version comment}}}
 +
|-
 +
 +
! Last review by: {{#info:Change this to your user name in case you have made substantial edits or have updated the version.}}
 +
| {{{field|Last review by}}}
 +
|-
 +
 +
! Last review date: {{#info:Change this date in case you have made substantial edits or have updated the version.}}
 +
| {{{field|Last review date|input type=datepicker|date format=yy-mm-dd}}}
 +
|-
 +
 +
! Submitted by: {{#info:Do not touch this unless you are creating a new entry. If you are updating an entry whose Submitted by entry is empty, keep it empty.}}
 +
| {{{field|Submitted by}}}
 +
|-
 +
 +
! Submitted date: {{#info:Do not touch this unless you are creating a new entry. If you are updating an entry whose Submitted date entry is empty, keep it empty.}}
 +
| {{{field|Submitted date|input type=datepicker|date format=yy-mm-dd}}}
 +
|-
 +
! User level:
 +
| {{{field|User level|input type=radiobutton}}}
 +
|-
 +
 +
! This is an extension, add-on, or plugin to:
 +
| {{{field|Extension of|input type=text with autocomplete}}}
 +
|-
 +
 +
! This is an inbuilt extension, add-on, or plugin to:
 +
|  {{{field|Inbuilt extension of|input type=text with autocomplete}}}
 +
|-
 +
 +
! Component programs:
 +
|{{{field|Component programs|input type=text with autocomplete}}}
 +
|-
 +
 +
! Paid support:
 +
|{{{field|Paid support}}}
 +
|-
 +
 +
! Accepts cryptocurrency donations:
 +
|{{{field|Accepts cryptocurrency donations|input type=checkbox}}}
 +
|-
 +
 +
! Checksum:
 +
| {{{field|Checksum}}}
 +
|-
 +
 +
 +
! OpenPGP signature URL: 
 +
| {{{field|OpenPGP signature}}}
 +
|-
 +
 +
! OpenPGP public key URL: 
 +
| {{{field|OpenPGP public key}}}
 +
|-
 +
 +
! Test entry:{{#info:Mark this page as a test entry}}
 +
| {{{field|Test entry|input type=checkbox}}}
 +
|}
 +
 +
It is recommended to add as many details of your software as possible for better popularity.
 +
 +
 +
''To save your changes, click the <strong>'Save'</strong> tab at the top of the page, then click the <strong>'Save page'</strong> button.''
 +
 +
</div>
 +
 +
<div style="display:none">{{{field|Status|hidden}}}</div>
 +
 +
=2. GNU =
 +
A project is GNU if it is listed at [https://gnu.org/software gnu.org/software]. The project's GNU package identifier is the lowercase name listed on that page.
 +
 +
{| class="formtable"
 +
! Is GNU:
 +
| {{{field|Is GNU|input type=checkbox}}}
 +
|-
 +
 +
! GNU package identifier:
 +
| {{{field|GNU package identifier}}}
 
|}
 
|}
{{{field|Status|hidden}}}
+
 
{{{field|Last review by|hidden}}}
 
{{{field|Last review date|hidden}}}
 
{{{field|Submitted by|hidden}}}
 
{{{field|Submitted date|hidden}}}
 
{{{field|License verified date|hidden}}}
 
 
{{{end template}}}
 
{{{end template}}}
  
=2. Licenses =
+
=3. Licenses =
 
{{{for template|Project license|strict|multiple}}}
 
{{{for template|Project license|strict|multiple}}}
'''License:''' {{{field|License}}}
+
'''License and version:''' {{{field|License|input type=combobox|values from property=License}}}
 +
 
 +
'''License copyright:''' {{{field|License copyright|input type=textarea}}}
  
 
'''License verified by:''' {{{field|License verified by}}}
 
'''License verified by:''' {{{field|License verified by}}}
  
'''License verified date:''' {{{field|License verified date}}}
+
'''License verified date:''' {{{field|License verified date|input type=datepicker|date format=yy-mm-dd}}}
  
'''License note:''' {{{field|License note}}}
+
'''License note:''' {{#info:You may put a link to the project's license file.}} {{{field|License note|input type=textarea}}}
  
 
{{{end template}}}
 
{{{end template}}}
  
 +
=4. Person info =
 +
{{{for template|Person|multiple}}}
 +
{| class="formtable"
 +
! Real name:
 +
| {{{field|Real name}}}
 +
|-
  
=3. Person info =
+
! Role:
{{{for template|Person|multiple|strict}}}
+
| {{{field|Role}}}
'''Real name:''' {{{field|Real name}}}
+
|-
  
'''Role:''' {{{field|Role}}}
+
! Email:
 +
| {{{field|Email}}}
 +
|-
  
'''Email:''' {{{field|Email}}}
+
! FSF username:
 +
| {{{field|Username}}}
 +
|}
  
'''Resource URL''' {{{field|Resource URL|hidden}}}
+
<div style="display:none">'''Resource URL''' {{{field|Resource URL|hidden}}}</div>
 
{{{end template}}}
 
{{{end template}}}
  
=4. Resource info=
+
=5. Resource info=
{{{for template|Resource|multiple|strict}}}
+
{{{for template|Resource|multiple}}}
'''Resource audience:''' {{{field|Resource audience}}}
+
{| class="formtable"
 
+
! Resource audience:
'''Resource kind:''' {{{field|Resource kind}}}
+
| {{{field|Resource audience}}}
 
+
|-
'''Resource URL:''' {{{field|Resource URL}}}
+
! Resource kind:
 
+
| {{{field|Resource kind}}}
 +
|-
 +
! Resource URL:
 +
| {{{field|Resource URL}}}
 +
|}
 
{{{end template}}}
 
{{{end template}}}
  
=5. Categories=
+
=6. Categories=
 
{{{for template|Software category|strict}}}
 
{{{for template|Software category|strict}}}
 
{| class="formtable"
 
{| class="formtable"
Line 189: Line 329:
 
| {{{field|Program-build-automation|property=Program-build-automation|input type=checkboxes}}}
 
| {{{field|Program-build-automation|property=Program-build-automation|input type=checkboxes}}}
 
|-
 
|-
! Programming-language:
+
! Programming-language: {{#info:The language the source code of the program is written in.}}
 
| {{{field|Programming-language|property=Programming-language|input type=checkboxes}}}
 
| {{{field|Programming-language|property=Programming-language|input type=checkboxes}}}
 
|-
 
|-
 
! Protocol:
 
! Protocol:
 
| {{{field|Protocol|property=Protocol|input type=checkboxes}}}
 
| {{{field|Protocol|property=Protocol|input type=checkboxes}}}
 +
|-
 +
! Runs-on:
 +
| {{{field|Runs-on|property=Runs-on|input type=checkboxes}}}
 
|-
 
|-
 
! Science:
 
! Science:
Line 213: Line 356:
 
| {{{field|Use|property=Use|input type=checkboxes}}}
 
| {{{field|Use|property=Use|input type=checkboxes}}}
 
|-
 
|-
! Version-control:
+
! UI Toolkit: {{#info:The user interface toolkit used by the program.}}
 +
| {{{field|Uitoolkit|property=Uitoolkit|input type=checkboxes}}}
 +
|-
 +
! Version-control: {{#info:Only check this for software interacting with version control systems, not just software being developed using a particular version control system.}}
 
| {{{field|Version-control|property=Version-control|input type=checkboxes}}}
 
| {{{field|Version-control|property=Version-control|input type=checkboxes}}}
 
|-
 
|-
Line 230: Line 376:
 
{{{end template}}}
 
{{{end template}}}
  
=6. Software prerequisites =
+
=7. Software prerequisites=
 
{{{for template|Software prerequisite|multiple}}}
 
{{{for template|Software prerequisite|multiple}}}
 
'''Prerequisite kind:''' {{{field|Prerequisite kind}}}
 
'''Prerequisite kind:''' {{{field|Prerequisite kind}}}
Line 238: Line 384:
 
{{{end template}}}
 
{{{end template}}}
  
=7. Editor copyright =
+
=8. Etc.=
Please remember to follow our contribution policies for when to mark a contribution as covered by copyright.
+
If a program has been featured somewhere, such as the FSF Supporter, then you may fill out the following:
 +
 
 +
{{{for template|Featured|strict}}}
 +
'''Featured date:''' {{{field|Featured date|restricted|input type=datepicker|date format=yy-mm-dd}}}
 +
 
 +
'''Featured source:''' {{{field|Featured source|restricted|maxlength=100}}}
 +
 
 +
'''Featured category:''' {{{field|Featured category|restricted|maxlength=100}}}
 +
 
 +
{{{end template}}}
  
http://directory-dev.fsf.org/wiki/Free_Software_Directory:Contribution_Policies
+
If a program has been imported from a distribution or packaging system.
{{{for template|Editor copyright|multiple|strict}}}
+
'''Editor copyright name:''' {{{field|Editor copyright name}}}
+
{{{for template|Import|multiple}}}
 +
'''Date:''' {{{field|Date|property=Import date|restricted|input type=datepicker|date format=yy-mm-dd}}}
  
'''Editor copyright year:''' {{{field|Editor copyright year}}}
+
'''Source:''' {{{field|Source|property=Import source|restricted}}}
  
 +
'''Source link:''' {{{field|Source link|property=Import source link|restricted}}}
 
{{{end template}}}
 
{{{end template}}}
  
 +
=9. Save=
 
{{{standard input|summary}}}
 
{{{standard input|summary}}}
  
 
{{{standard input|minor edit}}} {{{standard input|watch}}}
 
{{{standard input|minor edit}}} {{{standard input|watch}}}
  
{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
+
{{{standard input|save}}} {{{standard input|changes}}} {{{standard input|cancel}}}
 
<headertabs/>
 
<headertabs/>
  
 
</includeonly>
 
</includeonly>

Revision as of 13:55, 12 August 2018


Before adding a new entry to the Free Software Directory (FSD), please make sure that entry does not already exist by first using the Search box.

Programs added to the FSD must be useful free software and it must run on a completely free OS such as GNU/Linux. If the software runs on non-free operating system, then it must work as well or better on the completely free operating system as it does on the other operating systems.

To add a new entry, please enter the name of the program below. Please note that after submitting a new entry, your page will not be public until it has been reviewed and approved and published by administrators. However, you can continue to make edits to the page with your new entry on it after you submit it and before it has been approved for publication -- just click the edit button on the page after it is created.

The text you use here will be the end of the URL for that project page, so make sure that the text is typeable ASCII (A-Z, a-z, 0-9 and spaces), has no awkward symbols, ideally no accents, and uses the spacing and capitalization that the project uses. The idea is that people should be able to type it easily, regardless of language. Also, the shorter name is best, when multiple are available.






Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the page “GNU Free Documentation License”.

The copyright and license notices on this page only apply to the text on this page. Any software or copyright-licenses or other similar notices described in this text has its own copyright notice and license, which can usually be found in the distribution or license text itself.