Difference between pages "Help:Funtoo Editing Guidelines" and "Welcome"

(Difference between pages)
 
 
Line 1: Line 1:
This guide is meant to serve as a reference for those who are interested in helping improve the Funtoo Wiki.
+
<div class="container"><div class="row"><div class="col-xs-12 col-sm-8">
__TOC__
+
{{Slideshow}}
First, to perform edits on the wiki, you must {{CreateAccount}} and log in.
+
</div><div class="col-xs-12 col-sm-4">
 +
== Welcome to Funtoo Linux ==
 +
Funtoo Linux is a Linux-based operating system that is a variant of [http://www.gentoo.org Gentoo Linux]. Funtoo Linux is:
 +
* ...'''fun!''' Our priority is to create a ''great, supportive and responsive'' user community.
 +
* ...'''user-centric and collaborative'''. Everyone is considered a '''user''' of Funtoo, first and foremost. You don't need any special privileges to collaborate with us.
 +
* ...'''production-oriented''': Our goal is to have Funtoo be useful for ''real-world tasks''. We use Funtoo to do stuff, like host our infrastructure. It needs to work.__NOTOC__
 +
* ...'''creative''': We seek creative, elegant and maintainable solutions to problems of all kinds.
  
{{fancynote|A new wiki capability has been added, called ''annotations'', which allows you to make in-line comments to wiki text. To create or view annotations, click the '''View annotations''' tab. Hover over any yellow highlighted text to view an annotation (there is one for the first sentence of this page), or select text with your mouse and use the widget that appears to add your own annotation. Note that annotations are wiped when the page is edited.}}
+
'''View the [[Funtoo Linux FAQ]] for answers to common questions.'''
 
+
</div><div class="col-sm-12 col-sm-4">
You can create a new page by navigating to http://www.funtoo.org/New_Page_Name. Underscores are the equivalent of spaces. Then click the "Create" button in the upper right.
+
== Resources ==
 
+
Whether creating a new page or editing an existing page by clicking "Edit", you will be presented with Web-based text editor that allows you to modify the ''wikitext'' of the page. The wikitext is rendered to produce the document you see when you view the page normally.
+
 
+
This wiki uses the ApprovedRevs Extension, which means that any changes you make to a page will need to be approved by an Editor before they are displayed. Editors can visit the [[Special:ApprovedRevs]] page to approve edits made on pages (click "Pages whose approved revision is not their latest" or "Unapproved pages".)
+
 
+
Until your edits are approved, you can continue to edit the page and your changes will be displayed in the page's History -- click "View History" in the upper right to view the page's history. You will see that the approved version of a page has a star next to it.
+
 
+
Another fun thing you can do is click on your name in the upper right once you have logged in. This will bring you to your "User" page. Then click "Create with Form" and enter your geographic and other information. This will allow you to be displayed on our [[Usermap]] and will also allow your full name to be displayed on [[:Category:Ebuilds|Ebuild pages]] for which you are an author. It's generally a good idea to do this.
+
 
+
{{fancytip|The following sections document how to use wikitext and Funtoo templates on the Funtoo wiki.}}
+
 
+
== Paragraphs ==
+
 
+
To create a new paragraph, insert a blank line between two lines of text. If a blank line doesn't exist between two lines of wikitext, they will be combined into a single flowing paragraph.
+
 
+
If you leave leading whitespace at the beginning of a line, MediaWiki will render it as pre-formatted text. Beware of this. Here's an example:
+
 
+
foobar
+
 
+
== Page and Section Capitalization ==
+
 
+
In general, capitalize all words in page names and section heading except:
+
* Articles: a, an, the
+
* Coordinating Conjunctions: and, but, or, for, nor, etc.
+
* Prepositions (fewer than five letters): on, at, to, from, by, etc.
+
 
+
== Document Heirarchy ==
+
 
+
Use section headings to create a document heirarchy for your page. These will define the table of contents that appears at the top of the wiki page. Create chapters, sections and sub-sections as follows:
+
 
+
<pre>= Page Title =
+
 
+
== Chapter Title ==
+
 
+
=== Section Title ===
+
 
+
==== SubSection Title ====
+
 
+
</pre>
+
 
+
== Links ==
+
 
+
Internal links to other wiki pages can be specified as <tt><nowiki>[[pagename]]</nowiki></tt>. To specify an alternate name for the link, use <tt><nowiki>[[pagename|my link name]]</nowiki></tt>.
+
 
+
For external links, use <tt><nowiki>[http://funtoo.org my link]</nowiki></tt> to specify a URL. If you want the URL to appear in the wikitext, you can specify it without brackets: http://forums.funtoo.org.
+
 
+
== Lists ==
+
 
+
MediaWiki supports a number of list formats:
+
 
+
* Unordered List
+
* Unordered Item 2
+
** Unordered sub-item
+
 
+
# Ordered List
+
# Ordered Item 2
+
## Ordered sub-item
+
 
+
;Term: This is called a "definition list". It is used when defining various terms.
+
 
+
If you need to quote a portion of text from another site, use <tt><nowiki><blockquote></nowiki></tt> as follows:
+
 
+
<blockquote>
+
Wikipedia (ˌwɪkɨˈpiːdiə/ or wɪkiˈpiːdiə/ wik-i-pee-dee-ə) is a collaboratively edited, multilingual, free-access, free content Internet encyclopedia that is supported and hosted by the non-profit Wikimedia Foundation. Volunteers worldwide collaboratively write Wikipedia's 30 million articles in 287 languages, including over 4.5 million in the English Wikipedia. Anyone who can access the site can edit almost any of its articles, which on the Internet comprise[4] the largest and most popular general reference work.[5][6][7][8][9] In February 2014, The New York Times reported that Wikipedia is ranked fifth globally among all websites stating, "With 18 billion page views and nearly 500 million unique visitors a month..., Wikipedia trails just Yahoo, Facebook, Microsoft and Google, the largest with 1.2 billion unique visitors."[10]
+
</blockquote>
+
 
+
== Literal Text and HTML Symbols ==
+
 
+
Here is wikitext for the section above, which I am displaying by placing the literal wikitext between a &#60;pre&#62; and &#60;/pre&#62; tag. If you want to disable wikitext processing for an inline span of text, use &#60;nowiki&#62; and &#60;/nowiki&#62;. If you want to print out a tag literally, use &amp;#60; and &amp;#62; (In the wikitext, I used &amp;amp;#60; and &amp;amp;#62 to display these!)
+
 
+
<pre>
+
* Unordered List
+
* Unordered Item 2
+
** Unordered sub-item
+
 
+
# Ordered List
+
# Ordered Item 2
+
## Ordered sub-item
+
 
+
;Term: This is called a "definition list". It is used when defining various terms.
+
 
+
If you need to quote a portion of text from another site, use <tt><nowiki><blockquote></nowiki></tt> as follows:
+
 
+
<blockquote>
+
Wikipedia (ˌwɪkɨˈpiːdiə/ or wɪkiˈpiːdiə/ wik-i-pee-dee-ə) is a collaboratively edited, multilingual, free-access,
+
free content Internet encyclopedia that is supported and hosted by the non-profit Wikimedia Foundation. Volunteers
+
worldwide collaboratively write Wikipedia's 30 million articles in 287 languages, including over 4.5 million in the
+
English Wikipedia. Anyone who can access the site can edit almost any of its articles, which on the Internet
+
comprise[4] the largest and most popular general reference work.[5][6][7][8][9] In February 2014, The New York
+
Times reported that Wikipedia is ranked fifth globally among all websites stating, "With 18 billion page views
+
and nearly 500 million unique visitors a month..., Wikipedia trails just Yahoo, Facebook, Microsoft and Google,
+
the largest with 1.2 billion unique visitors."[10]
+
</blockquote>
+
</pre>
+
 
+
== Displaying Source Code ==
+
 
+
To display source code, use the <tt>&#60;syntaxhighlight&#62;</tt> tag, which has the ability to perform syntax highlighting on the source code for easier reading:
+
<pre>
+
<syntaxhighlight lang="python">
+
import system
+
</syntaxhighlight>
+
</pre>
+
 
+
This will produce the following output:
+
 
+
<syntaxhighlight lang="python">
+
import system
+
</syntaxhighlight>
+
 
+
Alternatively, if you need a caption, use can use the file template, specifying a <tt>lang=</tt> parameter:
+
 
+
<pre>
+
{{file|name=foobar|lang=python|desc=foobarosity|body=
+
import system
+
}}
+
</pre>
+
 
+
This will produce:
+
 
+
{{file|name=foobar|lang=python|desc=foobarosity|body=
+
import system
+
}}
+
 
+
{{fancyimportant|If you need to display the pipe ("{{!}}") character within the body of a file template, replace each "{{!}}" with <nowiki>{{!}}</nowiki> -- otherwise your file contents will not display properly. This is necessary because <nowiki>{{file}}</nowiki> is a template and the "{{!}}" character is used as a delimiter for arguments to the template.}}
+
 
+
Note that the language should be specified in the <tt>lang</tt> attribute. For a list of supported languages, see [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages this list].
+
 
+
== Displaying Text File Contents ==
+
 
+
For displaying the contents of non-programming language text files (like config files), you have two options. You can enclose your lines within <tt>&#60;pre&#62;</tt> tags, or use the new [[Template:File|file template]]. The file template is used like so:
+
 
+
<pre>
+
{{file|name=/etc/foo.conf|desc=My foo.conf file|body=
+
# /etc/host.conf:
+
# $Header: /var/cvsroot/gentoo/src/patchsets/glibc/extra/etc/host.conf,v 1.1 2006/09/29
+
}}
+
</pre>
+
 
+
This will produce:
+
 
+
{{file|name=/etc/foo.conf|desc=My foo.conf file|body=
+
# /etc/host.conf:
+
# $Header: /var/cvsroot/gentoo/src/patchsets/glibc/extra/etc/host.conf,v 1.1 2006/09/29
+
}}
+
 
+
== Console ==
+
To display console output, use the <tt>&#60;console&#62;</tt> tag:
+
 
+
For a root console:
+
<pre>
+
<console>
+
###i## run a command as root
+
</console>
+
</pre>
+
Produces:
+
<console>
+
###i## run a command as root
+
</console>
+
 
+
For a non-root console:
+
<pre>
+
<console>
+
$ ##i##run a command as user
+
</console>
+
</pre>
+
Produces:
+
<console>
+
$ ##i##run a command as user
+
</console>
+
  
 
{{fancyimportant|1=
 
{{fancyimportant|1=
Note that we use a <tt>#</tt> prompt for <tt>root</tt> and a <tt>$</tt> prompt to denote a non-root user.}}
+
[[Support Funtoo]] to help our project grow! '''Donate $15 per month and get a free [[Funtoo Hosting|Funtoo Virtual Container]].'''}}
  
{{Fancyimportant|The <tt>##i##</tt> text tags the rest of the line as being ''user input'' ("i" is for "input"). It is then highlighted in a noticeable color so it stands out from text that is not typed in by the user.}}
+
Our community has a number of excellent resources for communication and collaboration:
 +
* '''{{CreateAccount}}''' to log in to the wiki, forums and bug tracker. See [[Funtoo Authentication FAQ]].
 +
* '''[http://forums.funtoo.org forums.funtoo.org]''' - our new forums!
 +
* [https://groups.google.com/forum/#!forum/funtoo-dev funtoo-dev] mailing list
 +
* '''[http://bugs.funtoo.org bugs.funtoo.org]''', our bug tracker ([[Reporting Bugs|Instructions]]).
 +
* [http://larrythecow.org larrythecow.org], our Gentoo blog aggregation service.
 +
* [http://kernel-seeds.org kernel-seeds.org], resources for building your kernel from scratch.
 +
* [http://git.funtoo.org git.funtoo.org], our cgit repository browser.
 +
* '''[[Support Funtoo]]''' to help our project grow.
 +
* '''[[Funtoo Hosting|Get a Funtoo Virtual Container]]'''.
 +
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
 +
== Getting Started ==
  
If you need to end highlighting of user input prior to the end of a line, use <code>##!i##</code> to mark the end of the highlighted area.
+
We encourage you to [[Funtoo Linux Installation|install Funtoo Linux]], and get involved in our user community. Get to know fellow Funtoo Linux users on our [http://forums.funtoo.org forums]. If you have any improvements or find any bugs in Funtoo Linux, you are strongly encouraged to report them on our [http://bugs.funtoo.org bug tracker]. We take all bugs seriously, and all work performed on Funtoo Linux is tracked on our bug tracker, for purposes of transparency.
  
The following special character sequences are also available:
+
Funtoo Linux has a very active [http://en.wikipedia.org/wiki/IRC IRC] community on Freenode, in the <code>#funtoo</code> channel, and you are encouraged to hang out online with us.
* <code>##g##</code> - Green
+
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
* <code>##y##</code> - Yellow
+
== Project Structure ==
* <code>##bl##</code> - Blue
+
* <code>##r##</code> - Red
+
* <code>##b##</code> - Bold
+
  
Please use the above coloring options sparingly. It is sometimes nice to use them to get wiki console output to match the colors that are displayed on a Linux console. Also note that for every color above, there is a matching <code>##!(colorcode)##</code> option to turn color off prior to end of line.
+
Funtoo Linux is led by [http://en.wikipedia.org/wiki/Daniel_Robbins_(computer_programmer) Daniel Robbins], the creator and former Chief Architect of [http://en.wikipedia.org/wiki/Gentoo_Linux Gentoo Linux], who serves as benevolent dictator for life (BDFL) of the project. Our organizational structure consists of BDFL and a small number of support staff, as well as members of our user community who are involved in improving Funtoo Linux. Development efforts are driven by the BDFL as well as our users, and efforts are under way to implement various mechanisms to allow supporters of Funtoo Linux to chart the future direction of the project.
  
Here is an example of its use:<console>
+
'''Learn more about Funtoo Linux's [[staff]] and [[Funtoo Linux Vision|development vision]].'''
# ##i##bluetoothctl
+
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
[##g##NEW##!g##] Controller 00:02:72:C9:62:65 antec [default]
+
== Distinctives ==
##bl##[bluetooth]##!bl###power on
+
Changing power on succeeded
+
##bl##[bluetooth]##!bl### ##i##agent on
+
Agent registered
+
##bl##[bluetooth]##!bl### ##i##scan on
+
Discovery started
+
##bl##[bluetooth]##!bl### ##i##devices
+
Device 00:1F:20:3D:1E:75 Logitech K760
+
##bl##[bluetooth]##!bl### ##i##pair 00:1F:20:3D:1E:75
+
Attempting to pair with 00:1F:20:3D:1E:75
+
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: yes
+
##r##[agent]##!r## Passkey: 454358
+
##r##[agent]##!r## Passkey: ##i##4##!i##54358
+
##r##[agent]##!r## Passkey: ##i##45##!i##4358
+
##r##[agent]##!r## Passkey: ##i##454##!i##358
+
##r##[agent]##!r## Passkey: ##i##4543##!i##58
+
##r##[agent]##!r## Passkey: ##i##45435##!i##8
+
##r##[agent]##!r## Passkey: ##i##454358##!i##
+
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Paired: yes
+
Pairing successful
+
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: no
+
##bl##[bluetooth]##!bl### ##i##connect 00:1F:20:3D:1E:75
+
Attempting to connect to 00:1F:20:3D:1E:75
+
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: yes
+
Connection successful
+
##bl##[bluetooth]##!bl### ##i##quit
+
[##r##DEL##!r##] Controller 00:02:72:C9:62:65 antec [default]
+
#
+
</console>
+
  
== Fancy Notes ==
+
Funtoo Linux packages are installed from source code, automatically, thanks to the [http://en.wikipedia.org/wiki/Portage_(software) Portage ports system.], inspired by the FreeBSD ports system, but written in Python and with full advanced package management functionality. Funtoo Linux is a meta-distribution, which means it is built (fully automatically) with the functionality and optimizations that ''you'' want, not what some distro maintainer thought was best for you.
notes, warnings, tips, and important templates will help bring emphasis to articles drawn up.
+
<pre>{{fancynote|this is a fancy note}}</pre><br />
+
{{fancynote|this is a fancy note}}<br />
+
  
<pre>{{fancyimportant|this is a fancy important}}</pre><br />
+
We use [http://en.wikipedia.org/wiki/Git_(software) Git] for all our development, and we also use Git to deliver our ports tree to you.
{{fancyimportant|this is a fancy important}}<br />
+
  
<pre>{{fancywarning|this is a fancy warning}}</pre><br />
+
In contrast to Gentoo Linux, we offer a number of innovations, including our extensive use of git, [[Funtoo 1.0 Profile|our profile system]], [[Package:Boot-Update|boot-update]] boot management tool, our incredibly flexible [[Funtoo Linux Networking|template-based networking scripts]], [[Metro Quick Start Tutorial|Metro]] distribution build system, support of Debian, RHEL and other kernels, [[Creating_Python-related_Ebuilds|enhanced Python support]], Portage mini-manifests, user-centric distribution model, and a large number of community infrastructure improvements.
{{fancywarning|this is a fancy warning}}<br />
+
</div><div class="col-xs-12">
 +
== Help Document Ebuilds! ==
  
<pre>{{fancytip|this is a fancy tip}}</pre><br />
+
We need help adding documentation for ebuilds to our wiki. See below for a list of pages:
{{fancytip|this is a fancy tip}}<br />
+
  
== Kernelop ==
+
This page lists all ebuilds with pages on the Funtoo Linux wiki.
To display kernel configuration options, we encourage you to use the <tt>kernelop</tt> template. To use the <tt>kernelop</tt> template, create an entry similar to the following example:
+
<pre>
+
{{kernelop|title=foo,bar|desc=
+
kernel options pasted from "make menuconfig"
+
}}
+
</pre>
+
  
{{fancynote|Kernelop is colored blue to slightly resemble the blueish background from <tt>make menuconfig</tt>.}}
+
{{#ask:[[Category:Ebuilds]] [[CatPkg::+]]
 
+
|?CatPkg=
Adding this entry will give you the following output:
+
|?Repository=
{{kernelop|title=foo,bar|desc=
+
|?Summary=
kernel options
+
|format=listwidget
 +
|link=all
 +
|headers=show
 +
|searchlabel=… further results
 +
|class=sortable wikitable smwtable
 +
|limit=9999
 
}}
 
}}
  
Here's a more concrete example:
+
'''Add an Ebuild page:''' (see [[Adding an Ebuild to the Wiki]] for instructions)
{{kernelop|title=File systems|desc=
+
<M> Second extended fs support         
+
[ ]  Ext2 extended attributes         
+
[ ]   Ext2 execute in place support   
+
<M> Ext3 journalling file system support
+
}}
+
  
Examples of usage:  
+
{{#forminput:form=Ebuild|size=|default value=|button text=Add Package|autocomplete on namespace=Package|remote autocompletion|placeholder=Descriptive name|query string=namespace=Package}}
* [[Package:AMD Catalyst Video Drivers]]
+
* [[Package:ACPI Daemon]]
+
* [[Microcode]]
+
  
 +
== Help Document! ==
  
== Marking Pages as Needing Updates ==
+
The [[:Help:Funtoo_Editing_Guidelines | How to 'wiki']] sidebar link has several formatting examples.  Have a look at [[Requested-Documents]] and [[:Category:Needs_Updates | pages that need to be updated.]] Please search the wiki before creating pages to ensure that you are not duplicating efforts.
 
+
If you find outdated wiki content, but you don't have the time or ability to update it, add one of the following templates to the wikitext of the page. This will add the page to the [[:Category:Needs Updates|Needs Updates Category]] so we can identify pages that need updating:
+
 
+
<pre>
+
{{PageNeedsUpdates}}
+
{{SectionNeedsUpdates}}
+
</pre>
+
 
+
 
+
Examples of usage:
+
* [[UEFI Install Guide]]
+
* [[Package:MediaWiki]]
+
* [[Clang]]
+
 
+
== Inline Code ==
+
 
+
To emphasize filenames, commands, and other technical jargon when they appear inline in a paragraph, use the <tt>&#60;code&#62;</tt> element. Follow the example below:
+
 
+
<pre>
+
The <code>/etc/fstab</code> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
</pre>
+
 
+
This example produces the following output:
+
 
+
The <code>/etc/fstab</code> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
 
+
{{fancyimportant|1=
+
The &#60;tt&#62; tag has been deprecated for the purpose of tagging inline code, to conform with HTML5.}}
+
  
== Screencasting ==
+
</div></div></div>
screencasting is an easy method to explain complex tasks.  take for instance youtu.be/5KDei5mBfSg we chop off the id and insert it into the following syntax to produce a video example.<br />
+
tiny:
+
<pre>{{#widget:YouTube|id=5KDei5mBfSg|width=320|height=180}}</pre>
+
standard:
+
<pre>{{#widget:YouTube|id=5KDei5mBfSg|width=700|height=420}}</pre>
+
{{#widget:YouTube|id=5KDei5mBfSg|width=700|height=420}}
+
  
[[Category:Wiki Development]]
+
__NOTITLE__
 +
__NOEDITSECTION__
 +
{{#subobject:|slideIndex=0|slideCaption=|slideImage=/slideshow/13972219722_aa48a588c1_c.jpg}}
 +
{{#subobject:|slideIndex=1|slideCaption=|slideImage=/slideshow/14409383560_8a19a9b3d9_c.jpg}}

Revision as of 03:57, September 21, 2014

Welcome to Funtoo Linux

Funtoo Linux is a Linux-based operating system that is a variant of Gentoo Linux. Funtoo Linux is:

  • ...fun! Our priority is to create a great, supportive and responsive user community.
  • ...user-centric and collaborative. Everyone is considered a user of Funtoo, first and foremost. You don't need any special privileges to collaborate with us.
  • ...production-oriented: Our goal is to have Funtoo be useful for real-world tasks. We use Funtoo to do stuff, like host our infrastructure. It needs to work.
  • ...creative: We seek creative, elegant and maintainable solutions to problems of all kinds.

View the Funtoo Linux FAQ for answers to common questions.

Resources

Important

Support Funtoo to help our project grow! Donate $15 per month and get a free Funtoo Virtual Container.

Our community has a number of excellent resources for communication and collaboration:

Getting Started

We encourage you to install Funtoo Linux, and get involved in our user community. Get to know fellow Funtoo Linux users on our forums. If you have any improvements or find any bugs in Funtoo Linux, you are strongly encouraged to report them on our bug tracker. We take all bugs seriously, and all work performed on Funtoo Linux is tracked on our bug tracker, for purposes of transparency.

Funtoo Linux has a very active IRC community on Freenode, in the #funtoo channel, and you are encouraged to hang out online with us.

Project Structure

Funtoo Linux is led by Daniel Robbins, the creator and former Chief Architect of Gentoo Linux, who serves as benevolent dictator for life (BDFL) of the project. Our organizational structure consists of BDFL and a small number of support staff, as well as members of our user community who are involved in improving Funtoo Linux. Development efforts are driven by the BDFL as well as our users, and efforts are under way to implement various mechanisms to allow supporters of Funtoo Linux to chart the future direction of the project.

Learn more about Funtoo Linux's staff and development vision.

Distinctives

Funtoo Linux packages are installed from source code, automatically, thanks to the Portage ports system., inspired by the FreeBSD ports system, but written in Python and with full advanced package management functionality. Funtoo Linux is a meta-distribution, which means it is built (fully automatically) with the functionality and optimizations that you want, not what some distro maintainer thought was best for you.

We use Git for all our development, and we also use Git to deliver our ports tree to you.

In contrast to Gentoo Linux, we offer a number of innovations, including our extensive use of git, our profile system, boot-update boot management tool, our incredibly flexible template-based networking scripts, Metro distribution build system, support of Debian, RHEL and other kernels, enhanced Python support, Portage mini-manifests, user-centric distribution model, and a large number of community infrastructure improvements.

Help Document Ebuilds!

We need help adding documentation for ebuilds to our wiki. See below for a list of pages:

This page lists all ebuilds with pages on the Funtoo Linux wiki.

    
389 Directory Servernet-nds/389-ds-baseThis is the core part of 389 Directory Server -- technically, all you need for an LDAP deployment, although many will want to install 389-ds-admin for the graphical management capabilities, too.
389 Directory Server Admin Servernet-nds/389-adminThe 389 Directory Server Admin Server is an Apache-based application server that can optionally be deployed alongside 389 Directory Server. It allows for remote Java-based management of your 389 Directory Server deployment.
389 Directory Server AdminUtildev-libs/389-adminutilAdminUtil is a set of utility functions written in C, and a dependency of 389 Directory Server.
389 Directory Server Consoleapp-admin/389-ds-consoleThis is the Java-based remote management console that is used for managing 389 Directory Server (administration as well as the server app itself.)
ACPI Daemonsys-power/acpidDaemon for Advanced Configuration and Power Interface
AMD Catalyst Video Driversx11-drivers/ati-driversAccelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
APC UPS Daemonsys-power/apcupsdAPC UPS daemon with integrated network-based remote shutdown
Apachewww-servers/apacheThe Apache Web Server
Apache-toolsapp-admin/apache-toolsUseful Apache tools - htdigest, htpasswd, ab, htdbm
Ardourmedia-sound/ardourArdour is a fully featured audio and MIDI multi-track recording and editing digital audio workstation.
Audacious Music Playermedia-sound/audaciousAudacious is a lightweight GTK-based music player which supports many formats. It does not use the library concept but rather playlists for managing your music.
Awesome (Window Manager)x11-wm/awesomeA dynamic floating and tiling window manager.
BSF Bean Scripting Frameworkdev-java/bsfA framework that allows many scripting languages to be plugged into a Java application.
Baselayoutsys-apps/baselayoutFilesystem baselayout, initscripts and /sbin/realdev command
Bashapp-shells/bashThe standard GNU Bourne-again shell.
Bash completionapp-shells/bash-completionBash tab-completion
Batikdev-java/batikJava-based SVG toolkit.
Bindnet-dns/bindBIND - Berkeley Internet Name Domain - Name Server
Bind-toolsnet-dns/bind-toolsbind tools: dig, nslookup, host, nsupdate, dnssec-keygen
Bitwig Studiomedia-sound/bitwig-studioMusic production and performance system
Blendermedia-gfx/blender3D Creation/Animation/Publishing System
Boodev-lang/booA wrist-friendly language for the CLI.
Boot-Updatesys-boot/boot-updateFuntoo Core Boot Framework for global boot loader configuration
Boot-Update/pt-brsys-boot/boot-updateFuntoo Core Boot Framework for global boot loader configuration
CA Certificatesapp-misc/ca-certificatesThis package contains SSL certificates in PEM format that are used to validate the authenticity of remote systems, using the certificate authority system.
CCachedev-util/ccacheCCACHE is an application that caches compilation results and reuses it in future compilations in order to achieve faster compile times.
Camoramamedia-video/camoramaA webcam application featuring various image filters
Chromiumwww-client/chromiumChromium is the Open Source Web browser that serves as the foundation for Google Chrome.
Chronynet-misc/chronyChrony is a pair of programs (chronyd and chronyc) which are used to maintain the accuracy of the system clock on a computer. chronyd has been specifically written to work well for systems which have only an intermittent (e.g. dial-up) connection to the network where the NTP servers are. It still works well in a "permanently connected" mode.
Clamavapp-antivirus/clamavClam Anti-Virus Scanner
Comptonx11-miscA compositor for X.
Cx Oracledev-python/cx-oraclePython interface to Oracle.
Dashapp-shells/dashDASH is a direct descendant of the NetBSD version of ash (the Almquist SHell) and is POSIX compliant
Dbussys-apps/dbusA message bus ystem, a simple way for applications to talk to each other
DeaDBeeFmedia-sound/deadbeefA foobar2000-like music player
Dictd Moby Thesaurusapp-dicts/dictd-moby-thesaurusThis package contains the Moby Thesaurus, produced as part of the Moby Project. It is designed to work with dictd dictionary server.
Dirvish Backupapp-backup/dirvishSimple text-based configuration backup program composed of perl wrappers and using ssh and rsync
Dnscryptnet-dns/dnscrypt-proxyA tool for securing communications between a client, and a DNS resolver.
Dnsmasqnet-dns/dnsmasqSmall forwarding DNS server
Dovecotnet-mail/dovecotAn IMAP and POP3 server written with security primarily in mind
Drbdsys-cluster/drbdmirror/replicate block-devices across a network-connection: This is the user space tools to control, configure the DRBD driver, as well as integration programs and scripts that glues the DRBD system to cluster management software and other system components.
Drupalwww-apps/drupalPHP-based open-source platform and content management system
Dwmx11-wm/dwmdwm is extremely fast and lightweight window manager. It manages windows in tiled, floating and monocle layouts.
Eclipsedev-util/eclipse-sdk-binA powerful integrated development environment (IDE) written in Java.
Eixapp-portage/eixA command to search and query ebuilds, portage including local settings, overlays, version changes, and more.
Eselectapp-admin/eselectThis is Gentoo's multi-purpose management and configuration tool. The Funtoo version has been enhanced to support Funtoo's enhanced profile system.
Eselect (Java)app-admin/eselect-javaEselect (Java) is a Java module for eselect that is used to set the system JRE/JVM on Funtoo Linux systems.
Eselect (Jython)app-admin/eselect-jythonAn eselect module to manage the active system Jython implementation.
Eselect (OpenGL)app-admin/eselect-openglA Gentoo/Funtoo utility that allows the active OpenGL implementation on a system to be switched between a variety of installed options.
Eselect (Ruby)app-admin/eselect-rubyThis eselect module manages the active system implmentation of Ruby.
Eselect (Sh)app-admin/eselect-shThis eselect module manages the /bin/sh (POSIX shell) symlink.
Ethtoolsys-apps/ethtoolUtility for examining and tuning ethernet-based network interfaces
Fehmedia-gfx/fehA fast, lightweight imageviewer using imlib2
FreeMarkerdev-java/freemarkerFreeMarker is a template engine; a generic tool to generate text output based on templates.
GDMgnome-base/gdmGNOME Display Manager for managing graphical display servers and user logins
Genlopapp-portage/genlopA nice emerge.log parser.
Gentoo Syntax (Vim)app-vim/gentoo-syntaxA vim plugin that provides Funtoo ebuild, eclass, GLEP, ChangeLog and Portage file syntax highlighting, filetype and indent settings.
Gentoolkitapp-portage/gentoolkitCollection of administration scripts for funtoo
Gexiv2media-libs/gexiv2GObject-based wrapper around the Exiv2 library.
Ghost (Blogging Platform)www-apps/ghostGhost allows you to write and publish your own blog, giving you the tools to make it easy and even fun to do.
Gitdev-vcs/gitGIT - the stupid content tracker, the revision control system heavily used by the Linux kernel team
Git Subtreedev-vcs/git-subtreeAn experimental alternative to the git-submodule command. Merges and splits subtrees from your project into subprojects and back.
Gnome-sudokugames-puzzle/gnome-sudokuTest your logic skills in this number grid puzzle
Gnupgapp-crypt/gnupgThe GNU Privacy Guard, a GPL pgp replacement
Guiledev-scheme/guileGNU Ubiquitous Intelligent Language for Extensions.
Gzipapp-arch/gzipGzip is the standard GNU compressor/decompressor, used to create and expand .gz archives.
Hydrogenmedia-sound/hydrogenA high quality drum synthesizer and sequencer.
I3 (Window Manager)x11-wm/i3An improved dynamic tiling window manager
IBus Pinyinapp-i18n/ibus-pinyinChinese PinYin IMEngine for IBus Framework
IBus Tableapp-i18n/ibus-tableThe Table Engine for IBus Framework
Iproute2sys-apps/iproute2kernel routing and traffic control utilities
Iptablesnet-firewall/iptablesLinux kernel (2.4+) firewall, NAT and packet mangling tools
Irssinet-irc/irssiA modular textUI IRC client with IPv6 support.
JACK Audio Connection Kitmedia-sound/jack-audio-connection-kitA sophisticated audio routing and mixing application.
JSS (Network Security Services for Java)dev-java/jssNetwork Security Services for Java (JSS) is a Java interface to NSS.
Java SE Development Kit (JDK)dev-java/oracle-jdk-binOracle's Java SE Development Kit -- Java runtime, compiler, etc.
Java SE Runtime Environment (JRE)dev-java/oracle-jre-binOracle's Java SE Runtime Environment (JRE) - For running Java applications.
Jythondev-java/jythonAn implementation of Python written in Java.
KDE (metapackage)kde-base/kde-metaKDE - merge this to pull in all split kde-base/* packages
Keychainnet-misc/keychainKeychain helps you to manage ssh and GPG keys in a convenient and secure manner. It acts as a frontend to ssh-agent and ssh-add, but allows you to easily have one long running ssh-agent process per system, rather than the norm of one ssh-agent per login session.
LXCapp-emulation/lxcThe LXC package implements command-line, user-space utilities that allow you to use the Linux kernel's linux container functionality.
Lanmapnet-misc/lanmaplanmap sits quietly on a network and builds a picture of what it sees
Laymanapp-portage/laymanTool to manage Gentoo overlays
Lib usersapp-admin/lib_usersChecks /proc for libraries being mapped but marked as deleted
Libdc1394media-libs/libdc1394Library to interface with IEEE 1394 cameras following the IIDC specification.
Libgcryptdev-libs/libgcryptLibgcrypt is a general-purpose cryptographic library.
Libgcrypt (Compatibility Libraries)dev-libs/libgcrypt-compatLibgcrypt is a general purpose cryptographic library. This version of Libgcrypt is is designed to sit alongside an existing libgcrypt install, and just provide compatibility libs for apps that require an older libgcrypt.
Libgpg-Errordev-libs/libgpg-errorContains error handling functions used by GnuPG software.
Libmediascanmedia-libs/libmediascanC library for scanning audio/video/image file metadata.
Lightdmx11-misc/lightdmA lightweight display manager
Lighttpdwww-servers/lighttpdlighttpd a secure, fast, compliant and very flexible web-server which has been optimized for high-performance environments. It has a very low memory footprint compared to other webservers and takes care of cpu-load. Its advanced feature-set (FastCGI, CGI, Auth, Output-Compression, URL-Rewriting and many more) make lighttpd the perfect webserver-software for every server that is suffering load problems.
Lilosys-boot/liloStandard Linux boot loader
Linuxsamplermedia-sound/linuxsamplerLinuxSampler is a software audio sampler engine with professional grade features.
Lmmsmedia-sound/lmmsLMMS is a cross-platform software for music production.
Luadev-lang/luaA powerful light-weight programming language designed for extending applications
Luasecdev-lua/luasecLua binding for OpenSSL library to provide TLS/SSL communication.
Lxdmlxde-base/lxdmLXDE Display Manager
Macchangernet-analyzer/macchangerUtility for viewing/manipulating the MAC address of network interfaces
Mantisbtwww-apps/mantisbtPHP/MySQL/Web based bugtracking system
MariaDBdev-db/mariadbAn enhanced, drop-in replacement for MySQL
Media-player-infoapp-misc/media-player-infomedia-player-info is a repository of data files describing media player capabilities, mostly of mass-storage devices. These files contain information about the directory layout to use to add music to these devices, the supported file formats and so on.
MediaWikiwww-apps/mediawiki
Mesa 3D Graphics Librarymedia-libs/mesaAn Open Source implementation of the OpenGL specification
Metalogapp-admin/metalogMetalog is a light-weight and highly configurable system log daemon.
Minitubemedia-video/minitubeQt4 YouTube Client
MongoEnginedev-python/mongoengineA Python Object-Document-Mapper for working with MongoDB.
Monitapp-admin/monita utility for monitoring and managing daemons or similar programs running on a Unix system.
Monodev-lang/monoMono runtime and class libraries, a C# compiler/interpreter
Moshnet-misc/moshA replacement for SSH that is resilient to intermittent network connections, and supports roaming (changing) network connections.
Mozilla LDAP C SDKdev-libs/mozldapThis is the Mozilla LDAP SDK in the C language.
Mozilla LDAP Java SDKdev-java/ldapsdkThe Mozilla LDAP SDKs enable you to write applications which access, manage, and update the information stored in an LDAP directory.
Mozpluggerwww-plugins/mozpluggerStreaming media plugin for Mozilla, based on netscape-plugger
Mpdmedia-sound/mpdThe Music Player Daemon (mpd)
Mpvmedia-video/mpvVideo player based on MPlayer/mplayer2.
Muttmail-client/muttMutt is a popular mail reader for Linux systems.
MySQLdev-db/mysqlMySQL is a fast, multi-threaded, multi-user SQL database server.
NVIDIA Linux Display Driversx11-drivers/nvidia-driversNVIDIA accelerated graphics driver
Ncmpcppmedia-sound/ncmpcppFeatureful ncurses based MPD client inspired by ncmpc
Net-toolssys-apps/net-toolsStandard Linux networking tools
NetworkManagernet-misc/networkmanagerUniversal network configuration daemon for laptops, desktops, servers and virtualization hosts
Nftablesnet-firewall/nftablesLinux kernel (3.13+) firewall, NAT and packet mangling tools
Nginxwww-servers/nginxRobust, small and high performance HTTP and reverse proxy server
Nouveau Video Drivers (Open Source)x11-drivers/xf86-video-nouveauThe Nouveau video drivers are Open Source drivers providing 2D and 3D accelerated graphics for nVidia cards. Nouveau consists of the X.Org DDX driver (x11-drivers/xf86-video-nouveau), Linux kernel KMS driver (nouveau), and Gallium3D drivers in Mesa (media-libs/mesa).
Ntpnet-misc/ntpNetwork Time Protocol suite/programs
Open Sound System (OSS)media-sound/ossA portable, mixing-capable, high quality sound system for Unix.
OpenRCsys-apps/openrcOpenRC manages the services, startup and shutdown of a host.
OpenSSHnet-misc/opensshPort of OpenBSD's free SSH release
OpenSSLdev-libs/opensslFull-strength general purpose cryptography library (including SSL and TLS.)
Owncloudwww-apps/owncloudWeb-based storage application where all your data is under your own control
PAM basesys-auth/pambaseBase configuration files for different PAM implementations
PHPdev-lang/phpThe PHP language runtime engine: CLI, CGI, FPM/FastCGI, Apache2 and embed SAPIs
Passapp-admin/passPass is a password manager following the Unix philosophy.
Perldev-lang/perlLarry Wall's Practical Extraction and Report Language.
Pianobarmedia-sound/pianobarPianobar is a console client for the personalized web radio Pandora.
Piwikwww-apps/piwikPiwik is a downloadable, open source (GPL licensed) real time web analytics software program.
Plex Media Servermedia-tv/plex-media-serverPlex Media Server is a free media library that is intended for use with a plex client available for OS X, iOS, Android and various other devices.
Portage (Funtoo)sys-apps/portageThis is the official package manager/ports system for Funtoo Linux.
Portage-Utilsapp-portage/portage-utilsSmall and fast Portage helper tools written in C.
Postfixmail-mta/postfixA fast and secure drop-in replacement for sendmail.
Profanitynet-im/profanityNcurses based jabber client inspired by irssi
Proftpdnet-ftp/proftpdAn advanced and very configurable FTP server.
ProjectLibreapp-office/projectlibre-binAn Open Source replacement for Microsoft Project.
Pyzydev-libs/pyzyThe Chinese PinYin and Bopomofo conversion library.
Qjackctlmedia-sound/qjackctlA Qt application to control the JACK Audio Connection Kit and ALSA sequencer connections.
Qsamplermedia-sound/qsamplerQSampler is a graphical frontend to the LinuxSampler engine.
Qsynthmedia-sound/qsynthA Qt application to control FluidSynth
Qtcoredev-qt/qtcoreCross-platform application development framework
Qtractormedia-sound/qtractorAn Audio/MIDI multi-track sequencer
Quodlibetmedia-sound/quodlibetAn audio library tagger, manager, and player for GTK+
Radeon Video Driversx11-drivers/xf86-video-atiOpen source drivers for AMD video cards.
Renoisemedia-sound/renoiseRenoise is a Digital Audio Workstation with a unique top-down approach to music composition known as a tracker interface
Renoise (Demo)media-sound/renoise-demoRenoise is a Digital Audio Workstation with a unique top-down approach to music composition known as a tracker interface
Rsnapshotapp-backup/rsnapshotA filesystem backup utility based on rsync which implements space-efficient incremental backups using hard-links.
Rsyncnet-misc/rsyncRsync is a very fast file copying tool that has been optimized to synchronize files efficiently over a network connection.
Rtorrentnet-p2p/rtorrentBitTorrent Client using libtorrent
Rubydev-lang/rubyCentralized Ruby extension management system
Rutorrentwww-apps/rutorrentruTorrent is a front-end for the popular Bittorrent client rTorrent
SACD-Extractapp-cdr/sacd-extractPart of SACD-ripper, sacd-extract allows you to extract DSD data from SACD ISO files.
Saltapp-admin/saltSalt is a remote execution and configuration manager, written in Python.
Sambanet-fs/sambaSamba is an Open Source/Free Software suite that provides seamless file and print services to SMB/CIFS clients. Integration with various accounting and antivirus backends.
Sgmllibdev-python/sgmllibPort of sgmllib to python-3 (already part of python-2) - python2 versions will not install any files.
Slimx11-misc/slimSimple Login Manager
Smdevsys-fs/smdevsmdev is a device manager for the Linux kernel. It manages device nodes in the /dev directory.
Spectrwmx11-wm/spectrwmA small, dynamic tiling window manager for X11.
Squeezelitemedia-sound/squeezeliteSqueezelite is a small headless Squeezebox emulator for Linux using ALSA audio output.
Squidnet-proxy/squid
Sshfs-fusesys-fs/sshfs-fuseFuse-filesystem utilizing the sftp service
Sshguardapp-admin/sshguardprotects hosts from brute force attacks against ssh
Sublime Text Editorapp-editors/sublime-textSublime Text is an advanced commercial text editor.
Sudoapp-admin/sudoAllows users or groups to run commands as other users
Synapticsx11-drivers/xf86-input-synapticsDriver for Synaptics touchpads
Tenginewww-servers/tengineRobust, small and high performance http and reverse proxy server
Tmuxapp-misc/tmuxTerminal multiplexer
Unetbootinsys-boot/unetbootinUniversal Netboot Installer creates Live USB systems for various OS distributions
Valgrinddev-util/valgrindAn Open Source memory debugger for GNU/Linux.
Vanilla Sourcessys-kernel/vanilla-sourcesThe vanilla sources are the pure, unadulterated kernel sources as release by Linus Torvalds himself. No additional patches are applied.
Varnishwww-servers/varnishVarnish is a state-of-the-art, high-performance HTTP accelerator
Vifmapp-misc/vifmConsole file manager with vi(m)-like keybindings
Vimapp-editors/vimVim is an improved, vi-style text editor with many features.
VirtualBoxapp-emulation/virtualboxA desktop virtualization package from Oracle Corporation that allows you to run a guest operating system (Linux, Windows or other) on your Linux system.
Vlockapp-misc/vlockA console screen locker
Vsftpdnet-ftp/vsftpdVery Secure FTP Daemon written with speed, size and security in mind.
WPA Supplicantnet-wireless/wpa_supplicantwpa_supplicant is a cross-platform supplicant with support for open, WEP, WPA and WPA2. It handles scanning, connection and automatic reconnect to access points. wpa_supplicant has wpa_cli and wpa_gui frontends and wpa_supplicant daemon.
Warsowgames-fps/warsowWarsow is completely free fast-paced first-person shooter. It's based upon Qfusion, an advanced modification of Quake II engine.
Wgetpasteapp-text/wgetpasteCommand-line interface to various pastebins
Whenjobssys-process/whenjobsA cron daemon replacement that is powerful, yet simple.
Whiskermenuxfce-extra/xfce4-whiskermenu-pluginThis package installs the Whiskermenu plugin for xfce4, which serves as an alternative to the default application menu.
Wordpresswww-apps/wordpressWordpress php and mysql based content management system (CMS)
XDM (Display Manager)x11-apps/xdmX.Org xdm application
Xcachedev-php/xcacheA fast and stable PHP opcode cacher
Xfce4-terminalx11-terms/xfce4-terminalThe default terminal for the XFCE desktop environment.
Zsh-Completionapp-shells/zsh-completionProgrammable Completion for zsh (includes emerge and ebuild commands.)
ZynAddSubFXmedia-sound/zynaddsubfxZynAddSubFX is an open source software synthesizer. It includes three hybrid synth engines that combine additive, subtractive, fourier and other synthesis methods, and is available as a standalone, LV2 and DSSI plugin.

Add an Ebuild page: (see Adding an Ebuild to the Wiki for instructions)


Help Document!

The How to 'wiki' sidebar link has several formatting examples. Have a look at Requested-Documents and pages that need to be updated. Please search the wiki before creating pages to ensure that you are not duplicating efforts.