Difference between revisions of "Talk:PC-BSD® Users Handbook/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(Suggested addition: new section)
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
hi, any idea to break this page into smaller parts? like sub page?
 
  
I think that would be a good idea. Just haven't gotten to it yet. I did finish adding all the images today (4-17-09)
+
== Revised handbook structure ==
 +
Some of this has yet to be finalized, including shuffling of micro topics and sub-micro topics that do not get listed in the table of contents. Micro and sub-micro topics to be added. Key: {{highlight|Highlighted}} title changes, questions, and new topics. <s>Removed</s> or revised topics or titles.
  
>> great, I will test later (2009-04-18)
+
{{tbl-init}}
 +
{{tbl-title|revised}}
 +
{{tbl-title|current}}
 +
|-
 +
{{tbl-cell|row=1|align=top|content=<br>
 +
:Preface
  
>> *oops* I don't have any permission to create new page (2009-04-18)
+
:1. Introduction  {{highlight|<-- Example of Macro topic}}
  
please take a look @ http://wiki.pcbsd.org/index.php/PC-BSD_Users_Handbook#Supporting_PC-BSD
+
::1.1 PC-BSD's Goals and Features {{highlight|<-- Example of Topic}}
  
I've split it, if it's good enough, I will process the other page otherwise, I'll revert back
+
::1.2 What's New in 9.1
--------------
+
I have to say I don't care for the use of Wikis, especially for documentation. Can you tell who's writing what here for example?  It's all well and good to have users adding to documentation but it needs to be controlled and run through the same kind of approval process as code.  Not sure what sort of workflow/approval processes are available in Joomla, but in Drupal it's easy.  I'd recommend ditching the wiki concept and implementing documentation as a normal revision process within the CMS.  While I'm at it, I never understood the reason why mailing lists as a method of team communication still exist when forums are far superior.  Most of the PCBSD community doesn't participate in the mailing lists, and that's where a lot of great information is.  If they did participate, it would soon get completely out of hand and in-boxes would fill up with junk in short order.
+
  
As for this documentation wiki page, I didn't see anything get broken up.  It's still a very long page that takes forever to load if you don't have bandwidth.  You need to create separate URLs for each section.  Blogs invariably suffer from this same problem, but this is not a blog.  It's important to break into separate pages for other reasons as well: people need to make comments and ask questions (better done in a comment style, not a wiki) that are topic specific.
+
::1.3 PC-BSD Releases
  
...Jeff (May 18, 2009)
+
::1.4 PC-BSD for Linux Users
---------------
+
Can you explain the Runports concept a little better?  For example, if I install a port/package, do I have to run it using Runports(user) or not?  What's the diff?  If I have to, or it's advisable to, run a program using Runports, then shouldn't the menu command reflect that?  Maybe I'm not understanding the concept, but it seems to me it would have been preferable to make it so changing the PCBSD ports tree required Runports, rather than having to invoke it as a normal FreeBSD user.
+
  
....Jeff
+
:2. Pre-Installation Tasks
----------------
+
-------------------
+
  
== Suggested addition ==
+
::2.1 Hardware Requirements
  
I would suggest adding a humble moderation to this statement: Hardware such as video, sound, network and other devices are auto-detected and available at the first system startup.  
+
::2.2 Laptops
  
add: If recognised and a driver is available which in many instances isn't. Without a driver your device will not work.
+
::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 Desktop Selection Screen
 +
 
 +
::3.4 Disk Selection Screen
 +
 
 +
::3.5 Installation Progress Screen
 +
 
 +
::3.6 Installation Finished Screen
 +
 
 +
:4. Post Installation Configuration <s>and Installation Troubleshooting</s>
 +
 
 +
::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
 +
 
 +
::<s>4.9 Installation Troubleshooting</s>
 +
 
 +
:5. Advanced Installation Topics
 +
 
 +
::5.1 Install PC-BSD Server Edition (TrueOS)
 +
 
 +
::5.2 Dual Booting
 +
 
 +
::5.3 Multiple Boot Environments
 +
 
 +
::5.4 Upgrading PC-BSD
 +
 
 +
::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 Enlightenment
 +
 
 +
::6.7 evilwm
 +
 
 +
::6.8 Fluxbox
 +
 
 +
::6.9 FVWM
 +
 
 +
::6.10 i3
 +
 
 +
::6.11 IceWM
 +
 
 +
::6.12 Openbox
 +
 
 +
::6.13 Ratpoison
 +
 
 +
::6.14 spectrwm
 +
 
 +
::6.15 WindowLab
 +
 
 +
::6.16 Window Maker
 +
 
 +
:<s>7. Installing Applications and Keeping PC-BSD Updated</s>
 +
 
 +
::<s>7.1 Using AppCafe® </s>
 +
 
 +
::<s>7.2 PBI Manager</s>
 +
 
 +
::<s>7.3 Update Manager</s>
 +
 
 +
::<s>7.4 Meta Package Manager</s>
 +
 
 +
:8. Control Panel
 +
 
 +
::... {{highlight|AppCafe{{r}}}}
 +
 
 +
::8.1 EasyPBI
 +
 
 +
::8.2 About
 +
 
 +
::8.3 Active Directory & LDAP
 +
 
 +
::8.4 Hardware Compatibility
 +
 
 +
::8.5 GDM Configuration
 +
 
 +
::8.6 Service Manager
 +
 
 +
::8.7 System Manager
 +
 
 +
::8.8 User Manager
 +
 
 +
::8.9 Bluetooth Manager
 +
 
 +
::8.10 Mount Tray
 +
 
 +
::8.11 Sound Configuration
 +
 
 +
::8.12 Display
 +
 
 +
::8.13 Printing
 +
 
 +
::8.14 Scanner
 +
 
 +
::8.15 Network Configuration
 +
 
 +
::8.16 Firewall Manager
 +
 
 +
::8.17 Life Preserver
 +
 
 +
::8.18 Adobe Flash Player preferences
 +
 
 +
::8.19 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 ownCloud
 +
 
 +
::9.10 Security
 +
 
 +
::9.11 Accessibility
 +
 
 +
:... {{highlight|Troubleshooting}}
 +
 
 +
::.. {{highlight|Installation}}
 +
 
 +
:... {{highlight|TrueOS}}
 +
 
 +
::.. {{highlight|Working from the commandline}}
 +
 
 +
:::. {{highlight|PBI Manager}}
 +
 
 +
:::. {{highlight|Update Manager}}
 +
 
 +
:::. {{highlight|Meta Package Manager}}
 +
 
 +
:::. {{highlight|(other pc-* commands)}}
 +
 
 +
:10. Finding Help
 +
 
 +
::10.1 PC-BSD Forums
 +
 
 +
::10.2 IRC Channel
 +
 
 +
::10.3 Mailing Lists
 +
 
 +
::10.4 FreeBSD {{highlight|documentation}} <s>Handbook and FAQ</s>
 +
:::{{highlight|FAQ}}
 +
:::{{highlight|Handbook}}
 +
:::{{highlight|Manpages}}  {{highlight|<-- Example of Micro topic}}
 +
:::{{highlight|Wiki}}
 +
 
 +
::10.5 Social Media
 +
 
 +
::10.6 Search and Portals
 +
 
 +
::10.7 Other Resources
 +
 
 +
:11. Supporting PC-BSD  <!-- this seems to need some organization, perhaps from easiest to more difficult -->
 +
 
 +
::11.1 Become a Beta Tester
 +
 
 +
::11.2 Become a Translator
 +
 
 +
::11.3 Become a Developer
 +
 
 +
::11.4 Report Bugs
 +
 
 +
::11.5 {{highlight|Request PBIs}} <s>Submit PBI Requests</s>
 +
 
 +
::11.6 Test PBIs
 +
 
 +
::11.7 Create PBIs
 +
 +
::11.8 Purchase PC-BSD Swag
 +
 
 +
::11.9 Host a Mirror
 +
 
 +
::11.10 Seed a Torrent
 +
 
 +
::11.11 Become an Advocate
 +
}}
 +
{{tbl-cell|align=top|row=1|content=<br>{{hierB|title=Preface}}
 +
{{hierB|1.|title=Introduction}}
 +
{{hier|1.1|title=Goals and Features}}
 +
{{hier|1.2|title=What's New in 9.2}}
 +
{{hier|1.3|title=PC-BSD® Releases}}
 +
{{hier|1.4|title=PC-BSD® for Linux Users}}
 +
{{hierB|2.|title=Pre-Installation Tasks}}
 +
{{hier|2.1|title=Hardware Requirements}}
 +
{{hier|2.2|title=Laptops}}
 +
{{hier|2.3|title=Partitioning the Hard Drive}}
 +
{{hier|2.4|title=Obtaining PC-BSD®}}
 +
{{hier|2.5|title=Burning the Installation Media}}
 +
{{hier|2.6|title=PC-BSD® Live Mode}}
 +
{{hier|2.7|title=Using VirtualBox}}
 +
{{hierB|3.|title=Installing PC-BSD®}}
 +
{{hier|3.1|title=Starting the PC-BSD® Installation}}
 +
{{hier|3.2|title=Language Selection Screen}}
 +
{{hier|3.3|title=System Selection Screen}}
 +
{{hier|3.4|title=Disk Selection Screen}}
 +
{{hier|3.5|title=Installation Progress Screen}}
 +
{{hier|3.6|title=Installation Finished Screen}}
 +
{{hierB|4.|title=Post Installation Configuration and Installation Troubleshooting}}
 +
{{hier|4.1|title=Booting Into PC-BSD®}}
 +
{{hier|4.2|title=Language Screen}}
 +
{{hier|4.3|title=Time Zone Selection Screen}}
 +
{{hier|4.4|title=Set Root Password Screen}}
 +
{{hier|4.5|title=Create a User Screen}}
 +
{{hier|4.6|title=Connect to a Wireless Network}}
 +
{{hier|4.7|title=Post Install Finished Screen}}
 +
{{hier|4.8|title=Logging In}}
 +
{{hier|4.9|title=Installation Troubleshooting}}
 +
{{hierB|5.|title=Advanced Installation Topics}}
 +
{{hier|5.1|title=Install a Server}}
 +
{{hier|5.2|title=Dual Booting}}
 +
{{hier|5.3|title=Multiple Boot Environments}}
 +
{{hier|5.4|title=Upgrading PC-BSD®}}
 +
{{hier|5.5|title=Creating an Automated Installation with pc-sysinstall}}
 +
{{hierB|6.|title=Desktops}}
 +
{{hier|6.1|title=GNOME2}}<!-- First are the 'supported' desktops -->
 +
{{hier|6.2|title=KDE4}}
 +
{{hier|6.3|title=LXDE}}
 +
{{hier|6.4|title=XFCE4}}
 +
{{hier|6.5|title=Awesome}}<!-- Next are the 'unsupported' desktops -->
 +
{{hier|6.6|title=Enlightenment}}
 +
{{hier|6.7|title=evilwm}}
 +
{{hier|6.8|title=Fluxbox}}
 +
{{hier|6.9|title=FVWM}}
 +
{{hier|6.10|title=i3}}
 +
{{hier|6.11|title=IceWM}}
 +
{{hier|6.12|title=Openbox}}
 +
{{hier|6.13|title=Ratpoison}}
 +
{{hier|6.14|title=spectrwm}}
 +
{{hier|6.15|title=WindowLab}}
 +
{{hier|6.16|title=Window Maker}}
 +
{{hierB|7.|title=Installing Applications and Keeping PC-BSD® Updated}}
 +
{{hier|7.1|title=Using AppCafe®}}
 +
{{hier|7.2|title=PBI Manager}}
 +
{{hier|7.3|title=Update Manager}}
 +
{{hier|7.4|title=Meta Package Manager}}
 +
{{hier|7.5|title=Create Your Own PBI Repository}}
 +
{{hierB|8.|title=Control Panel}}<!-- This section follows the order the items are listed in the control panel -->
 +
{{hier|8.1|title=EasyPBI}}
 +
{{hier|8.2|title=About}}
 +
{{hier|8.3|title=Active Directory & LDAP}}
 +
{{hier|8.4|title=Hardware Compatibility}}
 +
{{hier|8.5|title=GDM Configuration}}
 +
{{hier|8.6|title=Service Manager}}
 +
{{hier|8.7|title=System Manager}}
 +
{{hier|8.8|title=User Manager}}
 +
{{hier|8.9|title=Bluetooth Manager}}
 +
{{hier|8.10|title=Mount Tray}}
 +
{{hier|8.11|title=Sound Configuration}}
 +
{{hier|8.12|title=Display}}
 +
{{hier|8.13|title=Printing}}
 +
{{hier|8.14|title=Scanner}}
 +
{{hier|8.15|title=Network Configuration}}
 +
{{hier|8.16|title=Firewall Manager}}
 +
{{hier|8.17|title=Life Preserver}}
 +
{{hier|8.18|title=Adobe Flash Player preferences}}
 +
{{hier|8.19|title=Warden®}}<!-- End control panel section - special item order -->
 +
{{hierB|9.|title=Using PC-BSD®}}
 +
{{hier|9.1|title=Java, Flash, and Fonts}}
 +
{{hier|9.2|title=Multimedia}}
 +
{{hier|9.3|title=Files and File Sharing}}
 +
{{hier|9.4|title=MythTV}}
 +
{{hier|9.5|title=XBMC}}
 +
{{hier|9.6|title=Windows Emulation}}
 +
{{hier|9.7|title=Remote Desktop}}
 +
{{hier|9.8|title=Thin Client}}
 +
{{hier|9.9|title=ownCloud}}
 +
{{hier|9.10|title=Security}}
 +
{{hier|9.11|title=Accessibility}}
 +
{{hierB|10.|title=Finding Help}}
 +
{{hier|10.1|title=PC-BSD® Forums}}
 +
{{hier|10.2|title=IRC Channel}}
 +
{{hier|10.3|title=Mailing Lists}}
 +
{{hier|10.4|title=FreeBSD Handbook and FAQ}}
 +
{{hier|10.5|title=Social Media}}
 +
{{hier|10.6|title=Search and Portals}}
 +
{{hier|10.7|title=Other Resources}}
 +
{{hierB|11.|title=Supporting PC-BSD®}}
 +
{{hier|11.1|title=Become a Beta Tester}}
 +
{{hier|11.2|title=Become a Translator}}
 +
{{hier|11.3|title=Become a Developer}}
 +
{{hier|11.4|title=Report Bugs}}
 +
{{hier|11.5|title=Submit PBI Requests}}
 +
{{hier|11.6|title=Test PBIs}}
 +
{{hier|11.7|title=PBI Module Builder Guide|alt=Create PBIs}}
 +
{{hier|11.8|title=Purchase PC-BSD® Swag}}
 +
{{hier|11.9|title=Host a Mirror}}
 +
{{hier|11.10|title=Seed a Torrent}}
 +
{{hier|11.11|title=Become an Advocate}}<br><br><br>
 +
}}
 +
|}
 +
 
 +
== appliance of [[:template:citelink]]?  ==
 +
 
 +
Salvete!
 +
 
 +
Should we use [[:template:citelink]] on this cover page too?
 +
 
 +
--[[User:Vater|Rg]] 14:26, 20 August 2012 (PDT)
 +
 
 +
Yes, I think its fair game here as well.
 +
 
 +
--[[User:Tigersharke|Tigersharke]] 20:19, 21 August 2012 (PDT)

Latest revision as of 04:25, 2 December 2013

[edit] Revised handbook structure

Some of this has yet to be finalized, including shuffling of micro topics and sub-micro topics that do not get listed in the table of contents. Micro and sub-micro topics to be added. Key: Highlighted title changes, questions, and new topics. Removed or revised topics or titles.

revised current

Preface
1. Introduction <-- Example of Macro topic
1.1 PC-BSD's Goals and Features <-- Example of Topic
1.2 What's New in 9.1
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 Desktop 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 PC-BSD Server Edition (TrueOS)
5.2 Dual Booting
5.3 Multiple Boot Environments
5.4 Upgrading PC-BSD
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 Enlightenment
6.7 evilwm
6.8 Fluxbox
6.9 FVWM
6.10 i3
6.11 IceWM
6.12 Openbox
6.13 Ratpoison
6.14 spectrwm
6.15 WindowLab
6.16 Window Maker
7. Installing Applications and Keeping PC-BSD Updated
7.1 Using AppCafe®
7.2 PBI Manager
7.3 Update Manager
7.4 Meta Package Manager
8. Control Panel
... AppCafe®
8.1 EasyPBI
8.2 About
8.3 Active Directory & LDAP
8.4 Hardware Compatibility
8.5 GDM Configuration
8.6 Service Manager
8.7 System Manager
8.8 User Manager
8.9 Bluetooth Manager
8.10 Mount Tray
8.11 Sound Configuration
8.12 Display
8.13 Printing
8.14 Scanner
8.15 Network Configuration
8.16 Firewall Manager
8.17 Life Preserver
8.18 Adobe Flash Player preferences
8.19 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 ownCloud
9.10 Security
9.11 Accessibility
... Troubleshooting
.. Installation
... TrueOS
.. Working from the commandline
. PBI Manager
. Update Manager
. Meta Package Manager
. (other pc-* commands)
10. Finding Help
10.1 PC-BSD Forums
10.2 IRC Channel
10.3 Mailing Lists
10.4 FreeBSD documentation Handbook and FAQ
FAQ
Handbook
Manpages <-- Example of Micro topic
Wiki
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 Report Bugs
11.5 Request PBIs Submit PBI Requests
11.6 Test PBIs
11.7 Create PBIs
11.8 Purchase PC-BSD Swag
11.9 Host a Mirror
11.10 Seed a Torrent
11.11 Become an Advocate



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 Dual Booting
5.3 Multiple Boot Environments
5.4 Upgrading PC-BSD®
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 Enlightenment
6.7 evilwm
6.8 Fluxbox
6.9 FVWM
6.10 i3
6.11 IceWM
6.12 Openbox
6.13 Ratpoison
6.14 spectrwm
6.15 WindowLab
6.16 Window Maker

7. Installing Applications and Keeping PC-BSD® Updated

7.1 Using AppCafe®
7.2 PBI Manager
7.3 Update Manager
7.4 Meta Package Manager
7.5 Create Your Own PBI Repository

8. Control Panel

8.1 EasyPBI
8.2 About
8.3 Active Directory & LDAP
8.4 Hardware Compatibility
8.5 GDM Configuration
8.6 Service Manager
8.7 System Manager
8.8 User Manager
8.9 Bluetooth Manager
8.10 Mount Tray
8.11 Sound Configuration
8.12 Display
8.13 Printing
8.14 Scanner
8.15 Network Configuration
8.16 Firewall Manager
8.17 Life Preserver
8.18 Adobe Flash Player preferences
8.19 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 ownCloud
9.10 Security
9.11 Accessibility

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 Report Bugs
11.5 Submit PBI Requests
11.6 Test PBIs
11.7 Create PBIs
11.8 Purchase PC-BSD® Swag
11.9 Host a Mirror
11.10 Seed a Torrent
11.11 Become an Advocate




[edit] appliance of template:citelink?

Salvete!

Should we use template:citelink on this cover page too?

--Rg 14:26, 20 August 2012 (PDT)

Yes, I think its fair game here as well.

--Tigersharke 20:19, 21 August 2012 (PDT)