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
doc:phd:view [2008/03/19 11:00] bjoridoc:phd:view [2017/09/22 13:28] (current) – external edit 127.0.0.1
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.+setup a ''phpweb'' mirror. 
  
-(Note; On Windows you are pretty much out of luck regarding instructions on setting up a ''phpweb'' mirroryou may try the following instructions but I have no idea if it would work.)+Note: These instructions likely don't work on Windowsbut 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 21: 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 webserverTada!+  * 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.1205924414.txt.gz · Last modified: 2017/09/22 13:28 (external edit)