Difference between pages "Help:Funtoo Editing Guidelines" and "New mainpage"

(Difference between pages)
m (<console>: revert console changes i made, root was botched and im not sure drobbins approved of it. see talk page if you want to enforce it drobbins.)
 
(Created page with "<div style="float:right; width: 35%"> {{#Widget:MonthlyDonate}} <div class="boxy"> == Featured Video == In this video, Jonathan Vasquez (fearedbliss) wal...")
 
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 style="float:right; width: 35%">
 +
{{#Widget:MonthlyDonate}}
 +
<div class="boxy">
 +
== Featured Video ==
  
= document hierarchy structure =
+
In this video, Jonathan Vasquez ([[User:Fearedbliss|fearedbliss]]) walks you through the process of installing Funtoo Linux with ZFS. See the [[ZFS Install Guide]] for detailed instructions.
<pre>= document hierarchy structure =</pre>
+
{{#widget:YouTube|id=kxEdSXwU0ZI|width=320|height=180}}
== document hierarchy sub structure ==
+
</div>
<pre>== document hierarchy sub structure ==</pre>
+
<div class="boxy">
this is the primary structure most pages, talk pages will use instead of main heading example above.  some pages will call for main heading.
+
== Get on the UserMap! ==
=== document hierarchy sub sub structure ===
+
{{#compound_query:[[Category:People]] [[Role type::Staff]];?Geoloc;icon=Purplemarker.png;limit=9999
<pre>=== document hierarchy sub sub structure ===</pre>
+
    |[[Category:People]][[Role type::Contributor]];?Geoloc;icon=Orangemarker.png;limit=9999
==== document hierarchy sub sub sub structure ====
+
    |[[Category:People]][[Role type::User]];?Geoloc;icon=Greenmarker.png;limit=9999
 +
    |format=googlemaps3|height=275|zoom=1|type=hybrid|markercluster=yes}}
 +
See our full-size [[Usermap]] and find out how to become part of the Funtoo Universe!
 +
</div>
 +
</div>
  
<pre>==== document hierarchy sub structure ====</pre>
+
== What is Funtoo Linux? ==
  
to implement pipe {{!}} in documents, wrap with brackets.
+
[[Funtoo Linux]] is a Linux-based operating system created by [[user:Drobbins|Daniel Robbins]], the creator and former Chief Architect of Gentoo Linux. Funtoo Linux is a Free software, or "Open Source" operating system. All distribution source code is freely available, and it can be used and distributed free of charge.
<pre>{{!}}</pre>
+
  
{{fancyimportant|below template is not instated yet}}
+
Who develops and improves Funtoo Linux? '''You do.''' We are a completely open meta-distribution that is run by our users and a small group of support staff. Our development centers around the needs of our users. Any user can contribute code and help improve Funtoo Linux functionality on our [http://bugs.funtoo.org bug tracker].  
to use equals signs with out conflicting with document structure wrap with brackets.
+
<div>
<pre>{{=}}</pre>
+
  
{{=}} http://en.wikipedia.org/wiki/Template:%3D
+
== What's New? ==
  
== &#60;console&#62; ==
+
{{Note}} Feb 12, 2014: '''Clean GNOME 3.6 merges''' from funtoo-gnome-overlay hit Portage tree, '''GNOME 3.10''' on horizon -- [https://groups.google.com/d/msg/funtoo-dev/4JLeMOn-xMk/SifhK2GsiBgJ Learn more here]...
To display console output, use the <tt>&#60;console&#62;</tt> tag:
+
  
For a root console:
+
== Resources ==
<pre>
+
<console>
+
###i## run a command as root
+
</console>
+
</pre>
+
Produces:
+
<console>
+
###i## run a command as root
+
</console>
+
  
{{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.}}
+
* Learn more about [[Funtoo Linux]].
 +
* Why you should [[Choose Funtoo]]: ...and how it is different from other distros.
 +
* Visit [[:Category:Projects|Funtoo Linux Projects]] and also look at the stuff online for [[Metro]].
 +
* Learn [[:Category:Linux Core Concepts| Core Linux concepts]] from articles originally written by Daniel Robbins.
 +
* [[Funtoo Linux Installation|Install Funtoo Linux]]
 +
Funtoo Linux is focused on the needs of our users. Here's how to get involved:
  
Examples of usage:
+
* '''wiki''': Help us maintain content on this wiki. Add yourself to the Funtoo [[Usermap]].
* [[Rootfs over encrypted lvm]]
+
* '''bugs''': Our [http://bugs.funtoo.org bug tracker] is used to track all ongoing development work in Funtoo Linux. If you find a bug in Funtoo Linux, report it here. Also used for enhancement requests.
* [[Boot-Update]]
+
* '''IRC''': Join us in the <tt>#funtoo</tt> IRC channel on <tt>irc.freenode.net</tt>.
* [[Fonts]]
+
* '''mailing list''': The [https://groups.google.com/forum/#!forum/funtoo-dev funtoo-dev mailing list] is used for development discussion.
For a non-root console:
+
* '''forums''': [http://forums.funtoo.org Funtoo Forums] are available for forum-style Funtoo discussion.
<pre>
+
* '''blogs''': [http://larrythecow.org LarryTheCow.org] is a blog aggregation service for Gentoo ecosystem developers and users.
<console>
+
* '''rss/atom''': [[Funtoo RSS and Atom Feeds]] displays the latest posts on the Forums and Planet Larry.
$ ##i##run a command as user
+
</console>
+
</pre>
+
Produces:
+
<console>
+
$ ##i##run a command as user
+
</console>
+
  
{{fancyimportant|1=
+
__NOTOC__
Note that we use a <tt>#</tt> prompt for <tt>root</tt> and a <tt>$</tt> prompt to denote a non-root user.}}
+
__NOTITLE__
 +
__NOEDITSECTION__
  
Examples of usage:
+
[[Category:Funtoo|*]]
* [[Zope HOWTO]]
+
* [[Benchmarking]]
+
 
+
or a more concise syntax
+
 
+
== Fancy Notes ==
+
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 />
+
{{fancyimportant|this is a fancy important}}<br />
+
 
+
<pre>{{fancywarning|this is a fancy warning}}</pre><br />
+
{{fancywarning|this is a fancy warning}}<br />
+
 
+
<pre>{{fancytip|this is a fancy tip}}</pre><br />
+
{{fancytip|this is a fancy tip}}<br />
+
 
+
 
+
<pre>bridge returns will help you edit articles also <br /> starts a new line</pre><br />
+
bridge returns will help you edit articles also <br /> starts a new line
+
 
+
== &#123;&#123;Kernelop&#125;&#125; ==
+
To display kernel 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"
+
<&#47;pre>}}
+
</pre>
+
 
+
Adding this entry will give you the following output:
+
{{kernelop|title=foo,bar|desc=
+
kernel options
+
}}
+
 
+
Here's a more concrete example:
+
{{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:
+
* [[Fglrx]]
+
* [[Acpid]]
+
* [[Microcode]]
+
 
+
== links ==
+
 
+
internal:<pre>[[pagename]]</pre><br />
+
[[pagename]]<br />
+
internal with text:<pre>[[pagename|some text]]</pre><br />
+
[[pagename|some text]]<br />
+
external: <pre>[http://funtoo.org/ http://funtoo.org/]</pre><br />
+
[http://funtoo.org/ http://funtoo.org/]<br />
+
external with text: <pre>[http://funtoo.org/ this is some text]</pre><br />
+
[http://funtoo.org/ this is some text]
+
 
+
== 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>
+
 
+
 
+
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 Files ==
+
To display the contents of a file that is not source code, use the <&#47;pre> tag. The <&#47;pre> tag preserves formatting. Example file contents:
+
 
+
<pre>
+
foo
+
bar
+
oni
+
</pre>
+
 
+
 
+
Examples of usage:
+
* [[UEFI Install Guide]]
+
* [[MediaWiki]]
+
* [[Clang]]
+
 
+
== &#60;tt&#62; and &#60;code&#62; ==
+
To emphasize filenames, commands, and other technical jargon when they appear inline in a paragraph, use the  <tt>&#60;tt&#62;</tt> or <tt>&#60;code&#62;</tt> option. To use these, follow the example below:
+
<pre>
+
The <tt>/etc/fstab</tt> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
</pre>
+
 
+
This example produces the following output (notice the difference between the fonts?): <br> The <tt>/etc/fstab</tt> file is an important one. Another important file is <code>/boot/grub/grub.cfg</code>.
+
 
+
== Collapsible text ==
+
 
+
<pre><div class="toccolours mw-collapsible"> some text you might want to fold away because its a huge explanation.</div></pre><br />
+
 
+
<div class="toccolours mw-collapsible"> some text you might want to fold away because its a huge explanation.</div><br />
+
 
+
<pre><div class="toccolours mw-collapsible mw-collapsed">pre collapsed text because it is a huge explanation.</div></pre><br />
+
 
+
<div class="toccolours mw-collapsible mw-collapsed">pre collapsed text because it is a huge explanation.</div>
+
 
+
== Screencasting ==
+
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]]
+

Revision as of 00:19, February 18, 2014

Featured Video

In this video, Jonathan Vasquez (fearedbliss) walks you through the process of installing Funtoo Linux with ZFS. See the ZFS Install Guide for detailed instructions.

Get on the UserMap!

See our full-size Usermap and find out how to become part of the Funtoo Universe!

What is Funtoo Linux?

Funtoo Linux is a Linux-based operating system created by Daniel Robbins, the creator and former Chief Architect of Gentoo Linux. Funtoo Linux is a Free software, or "Open Source" operating system. All distribution source code is freely available, and it can be used and distributed free of charge.

Who develops and improves Funtoo Linux? You do. We are a completely open meta-distribution that is run by our users and a small group of support staff. Our development centers around the needs of our users. Any user can contribute code and help improve Funtoo Linux functionality on our bug tracker.

What's New?

Note

{{{1}}}

Feb 12, 2014: Clean GNOME 3.6 merges from funtoo-gnome-overlay hit Portage tree, GNOME 3.10 on horizon -- Learn more here...

Resources

Funtoo Linux is focused on the needs of our users. Here's how to get involved:

  • wiki: Help us maintain content on this wiki. Add yourself to the Funtoo Usermap.
  • bugs: Our bug tracker is used to track all ongoing development work in Funtoo Linux. If you find a bug in Funtoo Linux, report it here. Also used for enhancement requests.
  • IRC: Join us in the #funtoo IRC channel on irc.freenode.net.
  • mailing list: The funtoo-dev mailing list is used for development discussion.
  • forums: Funtoo Forums are available for forum-style Funtoo discussion.
  • blogs: LarryTheCow.org is a blog aggregation service for Gentoo ecosystem developers and users.
  • rss/atom: Funtoo RSS and Atom Feeds displays the latest posts on the Forums and Planet Larry.