doc:phd:view

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
doc:phd:view [2008/03/19 10:55] – Simplify "mirroring" bjoridoc:phd:view [2009/03/08 08:58] – a basic rewrite philip
Line 1: Line 1:
 ====== Viewing the results ====== ====== Viewing the results ======
-After [[doc:phd|building the docs]] you probably want to view them now. +After [[doc:phd|building the docs]] it's time to view them. There are a few choices:
-You have a few choices: +
-  * See how it would be online (the php/ folder) +
-  * Just quickly see the results (the html/ folder) +
-  * Test how long it takes for your browser to render 20mb xhtml file (the bightml.html file)+
  
 +  * View how it would look online (the php/ folder, which uses the theme used by www.php.net)
 +  * View the plain html (the html/ folder)
 +  * View the single file plain html, which is around 20mb (the bightml.html file)
 +  * And other formats that require additional setup to the build environment: chm, pdf and *nix man pages
  
 ===== Viewing the php/ folder ===== ===== Viewing the php/ folder =====
-These files are tightly integrated into www.php.net, so to view them you need a ''phpweb'' mirror. +These files are tightly integrated into www.php.net, so to simplest way to view them is to 
-This method is currently the only "supported" method as the online manual is the most important one. If you don't have the ''fetch'' command, try ''wget'' or ''curl -O'' instead.+setup a ''phpweb'' mirror. 
  
-(Note; On Windows you are pretty much out of luck regarding instructions on setting up a ''phpweb'' mirror, you may try the following instructions but I have no idea if it would work.)+Note: These instructions likely don't work on Windows, but may, feel free to update them to do so (rsync alternative?) 
 + 
 +So, the mirrors use the **rsync** command. The following will work and it disables downloading parts of the mirror (like all the distributed php source files):
  
 <code bash> <code bash>
Line 20: Line 22:
 </code> </code>
  
-Now locate your webserver configuration file and add a new virtual host. +Notes: 
-For an example virtual host configuration, see [[http://www.php.net/mirroring.php#settings]]. +  * Change /path/to/your/webroot/phpweb  
-Now restart your webserver. Tada!+  * The 'ln -s' creates a symlink from your build directory to this location in the docroot 
 +  * The docroot will likely be setup as a new virtual host via the web server configuration file 
 +  * See also an example virtual host configuration here: [[http://www.php.net/mirroring.php#settings]]. 
 +  * Once the changes are made, restart the web server.
  
 ===== Viewing the html/ folder ===== ===== Viewing the html/ folder =====
  
 Do **//not//** place the contents of the html/ folder onto your webserver. Especially not if you are running apache2. Do **//not//** place the contents of the html/ folder onto your webserver. Especially not if you are running apache2.
-Just browse to the folder in your faviorite file manager and open the "index.html" file (or any page you are interested in viewing).+Just browse to the folder in your favorite file manager and open the "index.html" file (or any page you are interested in viewing).
  
 ===== Viewing the bightml.html file ===== ===== Viewing the bightml.html file =====
  
-Double click it.+Is that really wise? 
  
doc/phd/view.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1

Page Tools