Difference between revisions of "PC-BSD® Users Handbook/en"

From PC-BSD Wiki
Jump to: navigation, search
(Importing a new version from external source)
(Updating to match new version of source page)
(18 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
This is the wiki area for the collaborative editing of the ''' ''upcoming edition (rolling releases up to the next release, version 9.2)'' ''' of the PC-BSD® Users Handbook. If you are using a rolling release or would like to assist in documenting the next release, refer to the wiki version of the Handbook. Otherwise, refer to the version of the PC-BSD® Users Handbook that matches your version of PC-BSD®.
 
This is the wiki area for the collaborative editing of the ''' ''upcoming edition (rolling releases up to the next release, version 9.2)'' ''' of the PC-BSD® Users Handbook. If you are using a rolling release or would like to assist in documenting the next release, refer to the wiki version of the Handbook. Otherwise, refer to the version of the PC-BSD® Users Handbook that matches your version of PC-BSD®.
  
<onlyinclude>Beginning with PC-BSD® version 8.2, a PDF of the Users&nbsp;Handbook matching the released version is included as an icon on the PC-BSD®&nbsp;desktop. In addition, the Users&nbsp;Handbook is published in various formats as listed below. Translations of the Handbook are added as they become available and any downloadable file name will indicate the language with a [http://reference.sitepoint.com/html/lang-codes 2-letter&nbsp;ISO&nbsp;code]. If you are interested in translating a released version of the documentation, send an email to the [http://lists.pcbsd.org/mailman/listinfo/translations PC-BSD®&nbsp;translations&nbsp;mailing&nbsp;list].  
+
<onlyinclude>Beginning with PC-BSD® version 8.2, a PDF of the Users&nbsp;Handbook matching the released version is included as an icon on the PC-BSD®&nbsp;desktop. In addition, the Users&nbsp;Handbook is published in various formats as listed below. Translations of the Handbook are added as they become available and any downloadable file name will indicate the language with a {{citelink|url=http://reference.sitepoint.com/html/lang-codes|txt=2-letter&nbsp;ISO&nbsp;code}}. If you are interested in translating a released version of the documentation, send an email to the {{citelink|pcbsdlist|url=translations|txt=PC-BSD®&nbsp;translations&nbsp;mailing&nbsp;list}}.  
  
 
<blockquote style="border: 2px solid #666; padding: 10px; background-color: #ccc;" align="center">  
 
<blockquote style="border: 2px solid #666; padding: 10px; background-color: #ccc;" align="center">  
Line 60: Line 60:
 
</blockquote>
 
</blockquote>
  
{{:License}}</onlyinclude><!-- the 'onlyinclude' tag is for transclusion control and does not affect the page otherwise. -->
+
{{:License{{putLang}}}}</onlyinclude><!-- the 'onlyinclude' tag is for transclusion control and does not affect the page otherwise. -->
  
 
The Handbook grows into a useful resource when users (meaning you!) contribute to it. You do not have to write large sections of the Handbook in order to be a contributor. You also do not need to have a lot of time on your hands. You simply have to create a login account in order to assist with any of the following tasks:
 
The Handbook grows into a useful resource when users (meaning you!) contribute to it. You do not have to write large sections of the Handbook in order to be a contributor. You also do not need to have a lot of time on your hands. You simply have to create a login account in order to assist with any of the following tasks:
Line 78: Line 78:
 
''<center>Copyright 2011 - 2013, The PC-BSD® Project. PC-BSD® and the PC-BSD® logo are trademarks of [http://www.ixsystems.com iXsystems].</center>''  
 
''<center>Copyright 2011 - 2013, The PC-BSD® Project. PC-BSD® and the PC-BSD® logo are trademarks of [http://www.ixsystems.com iXsystems].</center>''  
 
''<center>All other content within the PC-BSD® Users Handbook is freely available for sharing under the terms of the [http://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution License].</center>''
 
''<center>All other content within the PC-BSD® Users Handbook is freely available for sharing under the terms of the [http://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution License].</center>''
<br>
+
<br />
 
<span style="font-size: 188%">Work in Progress: PC-BSD{{r}} Users Handbook (Rolling Release)</span>
 
<span style="font-size: 188%">Work in Progress: PC-BSD{{r}} Users Handbook (Rolling Release)</span>
  
Line 85: Line 85:
 
''' ''If the information and screenshots on the wiki do not match what you are seeing on your PC-BSD® system, it means it has changed since your version was released. You should instead refer to the Users Handbook that came with your version of PC-BSD®.'' '''
 
''' ''If the information and screenshots on the wiki do not match what you are seeing on your PC-BSD® system, it means it has changed since your version was released. You should instead refer to the Users Handbook that came with your version of PC-BSD®.'' '''
  
<br>
+
<br />
 
= Table of Contents =
 
= Table of Contents =
  
{{hierB|title=Preface}}<!--                       To update flat_html, copy all lines below this one up to the next comment. -->
+
{{hierB|title=Preface}}<br> <!-- Translators: The links below will not 'automagically' display properly unless each page below has its page title localized. -->
 
{{hierB|1.|title=Introduction}}
 
{{hierB|1.|title=Introduction}}
 
{{hier|1.1|title=Goals and Features}}
 
{{hier|1.1|title=Goals and Features}}
Line 124: Line 124:
 
{{hier|5.3|title=Using a Rolling Release}}
 
{{hier|5.3|title=Using a Rolling Release}}
 
{{hier|5.4|title=Dual Booting}}
 
{{hier|5.4|title=Dual Booting}}
{{hier|5.5|title=Multiple Boot Environments}}
+
{{hier|5.5|title=Creating an Automated Installation with pc-sysinstall}}
{{hier|5.6|title=Creating an Automated Installation with pc-sysinstall}}
+
 
{{hierB|6.|title=Desktops}}
 
{{hierB|6.|title=Desktops}}
 
{{hier|6.1|title=GNOME2}}<!-- First are the 'supported' desktops -->
 
{{hier|6.1|title=GNOME2}}<!-- First are the 'supported' desktops -->
Line 132: Line 131:
 
{{hier|6.4|title=XFCE4}}
 
{{hier|6.4|title=XFCE4}}
 
{{hier|6.5|title=Awesome}}<!-- Next are the 'unsupported' desktops -->
 
{{hier|6.5|title=Awesome}}<!-- Next are the 'unsupported' desktops -->
{{hier|6.6|title=Enlightenment}}
+
{{hier|6.6|title=Fluxbox}}
{{hier|6.7|title=evilwm}}
+
{{hier|6.7|title=FVWM}}
{{hier|6.8|title=Fluxbox}}
+
{{hier|6.8|title=i3}}
{{hier|6.9|title=FVWM}}
+
{{hier|6.9|title=IceWM}}
{{hier|6.10|title=i3}}
+
{{hier|6.10|title=Openbox}}
{{hier|6.11|title=IceWM}}
+
{{hier|6.11|title=Ratpoison}}
{{hier|6.12|title=Openbox}}
+
{{hier|6.12|title=spectrwm}}
{{hier|6.13|title=Ratpoison}}
+
{{hier|6.13|title=WindowLab}}
{{hier|6.14|title=spectrwm}}
+
{{hier|6.14|title=Window Maker}}
{{hier|6.15|title=Window Maker}}
+
{{hierB|7.|title=Installing Applications and Keeping Up-to-Date}}
{{hierB|7.|title=Installing Applications and Keeping PC-BSD® Updated}}
+
{{hier|7.1|title=AppCafe®}}
{{hier|7.1|title=Using AppCafe®}}
+
 
{{hier|7.2|title=Package Manager}}
 
{{hier|7.2|title=Package Manager}}
{{hier|7.3|title=PBI Manager}}
+
{{hier|7.3|title=Update Manager}}
{{hier|7.4|title=Using pkgng}}
+
{{hier|7.4|title=PBI Manager}}
{{hier|7.5|title=Update Manager}}
+
{{hier|7.5|title=pkgng and pc-metapkgmanager}}
{{hier|7.6|title=Upgrading PC-BSD®}}
+
{{hier|7.6|title=pc-updatemanager}}
{{hier|7.7|title=Create Your Own PBI Repository}}
+
 
{{hierB|8.|title=Control Panel}}<!-- This section follows the order the items are listed in the control panel -->
 
{{hierB|8.|title=Control Panel}}<!-- This section follows the order the items are listed in the control panel -->
 
{{hier|8.1|title=EasyPBI2}}
 
{{hier|8.1|title=EasyPBI2}}
Line 181: Line 178:
 
{{hier|9.7|title=Remote Desktop}}
 
{{hier|9.7|title=Remote Desktop}}
 
{{hier|9.8|title=Thin Client}}
 
{{hier|9.8|title=Thin Client}}
{{hier|9.9|title=ownCloud}}
+
{{hier|9.9|title=Security}}
{{hier|9.10|title=Security}}
+
{{hier|9.10|title=Accessibility}}
{{hier|9.11|title=Accessibility}}
+
{{hier|9.11|title=Create Your Own PBI Repository}}
 
{{hierB|10.|title=Finding Help}}
 
{{hierB|10.|title=Finding Help}}
 
{{hier|10.1|title=PC-BSD® Forums}}
 
{{hier|10.1|title=PC-BSD® Forums}}
Line 196: Line 193:
 
{{hier|11.2|title=Become a Translator}}
 
{{hier|11.2|title=Become a Translator}}
 
{{hier|11.3|title=Become a Developer}}
 
{{hier|11.3|title=Become a Developer}}
{{hier|11.4|title=Report Bugs}}
+
{{hier|11.4|title=Submit PBI Requests}}
{{hier|11.5|title=Submit PBI Requests}}
+
{{hier|11.5|title=Test PBIs}}
{{hier|11.6|title=Test PBIs}}
+
{{hier|11.6|title=PBI Module Builder Guide|alt=Create PBIs}}
{{hier|11.7|title=Create PBIs}}
+
{{hier|11.7|title=Purchase PC-BSD® Swag}}
{{hier|11.8|title=Purchase PC-BSD® Swag}}
+
{{hier|11.8|title=Become an Advocate}}
{{hier|11.9|title=Seed a Torrent}}
+
{{hier|11.10|title=Become an Advocate}}
+
 
<!-- The above chapter titles should also be placed in the 'flat html' page; when changes are made here, please make them there. Simply paste them as-is into the flat_html page as the comments there direct. Some modifications are needed before or after: words hier and hierb need to be changed to 'flatten' on the flat_html page. -->
 
<!-- The above chapter titles should also be placed in the 'flat html' page; when changes are made here, please make them there. Simply paste them as-is into the flat_html page as the comments there direct. Some modifications are needed before or after: words hier and hierb need to be changed to 'flatten' on the flat_html page. -->
 
<noinclude>
 
<noinclude>
 +
{{refheading}}
 
[[category:PC-BSD® Wiki]]
 
[[category:PC-BSD® Wiki]]
 
[[category:Handbook]]
 
[[category:Handbook]]
 
<languages />
 
<languages />
 
</noinclude>
 
</noinclude>

Revision as of 08:46, 24 September 2013


PC-BSD® Users HandbookProtection (edit): Edited by: FuzzyBot

This is the wiki area for the collaborative editing of the upcoming edition (rolling releases up to the next release, version 9.2) of the PC-BSD® Users Handbook. If you are using a rolling release or would like to assist in documenting the next release, refer to the wiki version of the Handbook. Otherwise, refer to the version of the PC-BSD® Users Handbook that matches your version of PC-BSD®.

Beginning with PC-BSD® version 8.2, a PDF of the Users Handbook matching the released version is included as an icon on the PC-BSD® desktop. In addition, the Users Handbook is published in various formats as listed below. Translations of the Handbook are added as they become available and any downloadable file name will indicate the language with a 2-letter ISO code[1]. If you are interested in translating a released version of the documentation, send an email to the PC-BSD® translations mailing list[2].

Published Versions (in reverse chronological order):

PC-BSD® 9.1 was released on 18 Dec 2012. The 9.1 Users Handbook is available in the following formats:

PC-BSD® 9.0 was released on 13 Jan 2012. The 9.0 Users Handbook is available in the following formats:

  • For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 9.0 Handbook (English Version)" is available from Amazon. The ASIN is B006W0EHN8 and this version is text-to-speech enabled.
  • For those who prefer a "dead tree" version of the Handbook, the book version as well as a book and DVD bundle are available from FreeBSD Mall. The ISBN for the book is 1-57176-398-8.

PC-BSD® 8.2 was released on 24 Feb 2011. The 8.2 Users Handbook is available in the following formats:

  • For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 8.2 Handbook (English Version)" is available from Amazon. The ASIN is B004SP6PXY and this version is text-to-speech enabled.

All versions of the PC-BSD® Handbook are released under the Creative Commons Attribution License. This means that you are free to distribute, modify, translate, and convert the Handbook to other formats, as long as your version retains the following attribution text:

Copyright 2011-2014, The PC-BSD® Project.

PC-BSD® and the PC-BSD® logo are trademarks of iXsystems.

If you translate the handbook to another language, or convert it to other formats, please let us know so that we can help you spread the word and include it on the FTP server.

The Handbook grows into a useful resource when users (meaning you!) contribute to it. You do not have to write large sections of the Handbook in order to be a contributor. You also do not need to have a lot of time on your hands. You simply have to create a login account in order to assist with any of the following tasks:

  • proofread existing pages and fix any typos, grammos, or unclearly worded sections.
  • add to sections containing missing, outdated, or incomplete content.
  • update any screenshots that are out of date.
  • every page has a Discussion tab. You can use this if you would like to suggest further information that should appear in that section of the Handbook.
  • create a new section for content that is not yet covered in the Handbook. If you are not sure where to do this, ask on a semi-related Discussion tab.

We are emailed whenever edits are made and will contact you for clarification if an edit is unclear. You can also be notified when specified pages are edited--simply click the "my preferences" or "my watchlist" links whenever you are logged into the wiki.

Copyright 2011 - 2013, The PC-BSD® Project. PC-BSD® and the PC-BSD® logo are trademarks of iXsystems.
All other content within the PC-BSD® Users Handbook is freely available for sharing under the terms of the Creative Commons Attribution License.


Work in Progress: PC-BSD® Users Handbook (Rolling Release)

Beginning in February, 2013, PC-BSD® switched to a rolling release model for those users who wish to test changes that will be incorporated into the next release of PC-BSD®. The wiki is used to document these changes.

If the information and screenshots on the wiki do not match what you are seeing on your PC-BSD® system, it means it has changed since your version was released. You should instead refer to the Users Handbook that came with your version of PC-BSD®.


Table of Contents

Preface
1. Introduction

1.1 Goals and Features
1.2 What's New in 9.2
1.3 PC-BSD® Releases
1.4 PC-BSD® for Linux Users

2. Pre-Installation Tasks

2.1 Hardware Requirements
2.2 Laptops
2.3 Partitioning the Hard Drive
2.4 Obtaining PC-BSD®
2.5 Burning the Installation Media
2.6 PC-BSD® Live Mode
2.7 Using VirtualBox

3. Installing PC-BSD®

3.1 Starting the PC-BSD® Installation
3.2 Language Selection Screen
3.3 System Selection Screen
3.4 Disk Selection Screen
3.5 Installation Progress Screen
3.6 Installation Finished Screen

4. Post Installation Configuration and Installation Troubleshooting

4.1 Booting Into PC-BSD®
4.2 Language Screen
4.3 Time Zone Selection Screen
4.4 Set Root Password Screen
4.5 Create a User Screen
4.6 Connect to a Wireless Network
4.7 Post Install Finished Screen
4.8 Logging In
4.9 Installation Troubleshooting

5. Advanced Installation Topics

5.1 Install a Server
5.2 Convert a FreeBSD System to PC-BSD®
5.3 Using a Rolling Release
5.4 Dual Booting
5.5 Creating an Automated Installation with pc-sysinstall

6. Desktops

6.1 GNOME2
6.2 KDE4
6.3 LXDE
6.4 XFCE4
6.5 Awesome
6.6 Fluxbox
6.7 FVWM
6.8 i3
6.9 IceWM
6.10 Openbox
6.11 Ratpoison
6.12 spectrwm
6.13 WindowLab
6.14 Window Maker

7. Installing Applications and Keeping Up-to-Date

7.1 AppCafe®
7.2 Package Manager
7.3 Update Manager
7.4 PBI Manager
7.5 pkgng and pc-metapkgmanager
7.6 pc-updatemanager

8. Control Panel

8.1 EasyPBI2
8.2 About
8.3 Active Directory & LDAP
8.4 Boot Manager
8.5 Hardware Compatibility
8.6 GDM Manager
8.7 Service Manager
8.8 System Manager
8.9 User Manager
8.10 Bluetooth Manager
8.11 Mount Tray
8.12 Sound Configuration
8.13 Display
8.14 Printing
8.15 Scanner
8.16 Network Configuration
8.17 Firewall Manager
8.18 Adobe Flash Player preferences
8.19 Life Preserver
8.20 PC-BSD® Bug Reporting
8.21 Warden®

9. Using PC-BSD®

9.1 Java, Flash, and Fonts
9.2 Multimedia
9.3 Files and File Sharing
9.4 MythTV
9.5 XBMC
9.6 Windows Emulation
9.7 Remote Desktop
9.8 Thin Client
9.9 Security
9.10 Accessibility
9.11 Create Your Own PBI Repository

10. Finding Help

10.1 PC-BSD® Forums
10.2 IRC Channel
10.3 Mailing Lists
10.4 FreeBSD Handbook and FAQ
10.5 Social Media
10.6 Search and Portals
10.7 Other Resources

11. Supporting PC-BSD®

11.1 Become a Beta Tester
11.2 Become a Translator
11.3 Become a Developer
11.4 Submit PBI Requests
11.5 Test PBIs
11.6 Create PBIs
11.7 Purchase PC-BSD® Swag
11.8 Become an Advocate


References


  1. http://reference.sitepoint.com/html/lang-codes
  2. http://lists.pcbsd.org/mailman/listinfo/translations


Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox