Merge remote-tracking branch 'upstream/master'

Conflicts:
	README.md
This commit is contained in:
kisselev 2013-07-30 09:16:55 -07:00
commit 4763b8d970
10 changed files with 195 additions and 29 deletions

View File

@ -191,16 +191,29 @@ Set custom files and entire folders to ignore within your `/docs` folder. For fi
###Disabling clean URLs
By default, Daux.io will create clean url's that do not include index.php. On servers running Apache, uploading the included .htaccess file should be enough for them to work properly. On servers that are not running Apache or that do not allow custom .htaccess files, you may need to disable clean_urls:
```json
{
"clean_urls": false
}
```
###Date Modified
By default, daux.io will display the last modified time as reported by the system underneath the title for each document. To disable this, change the option in your config.json to false.
```json
{
"date_modified": false
}
```
###Timezone
If your server does not have a default timezone set in php.ini, it may return errors when it tries to generate the last modified date/time for docs. To fix these errors, specify a timezone in your config file. Valid options are available in the [PHP Manual](http://php.net/manual/en/timezones.php).
```json
{
"timezone": "America/Los_Angeles"
}
```
## Running Remotely
@ -221,6 +234,52 @@ The Grunt.js task uses the built in web server in PHP 5.4 to host the docs on yo
This project contains a package.json file, so once you have the requirements installed, you can simply run a `npm install` and then `grunt` in the projects folder to start the local web server. By default the server will run at: <a href="http://localhost:8085" target="_blank">http://localhost:8085</a>
## Running on IIS
If you have set up a local or remote IIS web site, you may need a `web.config` with:
* A rewrite configuration, for handling clean urls.
* A mime type handler for less files, if using a custom theme.
### Clean URLs
The `web.config` needs an entry for `<rewrite>` under `<system.webServer>`:
```xml
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Main Rule" stopProcessing="true">
<match url=".*" />
<conditions logicalGrouping="MatchAll">
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
</conditions>
<action type="Rewrite" url="index.php" appendQueryString="false" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
```
To use clean URLs on IIS 6, you will need to use a custom URL rewrite module, such as [URL Rewriter](http://urlrewriter.net/).
### Less Mime Type
The `web.config` needs a new `<mimeMap>` entry, under `<staticContent>` in `<system.webServer>`:
```xml
<staticContent>
<mimeMap fileExtension=".less" mimeType="text/css" />
</staticContent>
```
You will only need the mime map entry if you are using a custom theme and receive 404s for `.less` files.
If you have a global mime map entry for `.less` files set for the server, you will receive an internal server (500) error for having duplicate mime map entries.
## Support
If you need help using Daux.io, or have found a bug, please create an issue on the <a href="https://github.com/justinwalsh/daux.io/issues" target="_blank">GitHub repo</a>.

View File

@ -6720,11 +6720,15 @@ code {
}
.page-header {
margin: 10px 0px;
padding: 0px 0 20px;
padding: 0px;
}
.page-header h1 {
margin-top: 0px;
}
/* To be applied to the same element as page-header for sites that have sub-heading content such as Last modified time */
.page-header .sub-heading {
padding: 0px, 0px, 20px;
}
pre {
border: none;
background-color: #82becd;

View File

@ -6720,11 +6720,15 @@ code {
}
.page-header {
margin: 10px 0px;
padding: 0px 0 20px;
padding: 0px;
}
.page-header h1 {
margin-top: 0px;
}
/* To be applied to the same element as page-header for sites that have sub-heading content such as Last modified time */
.page-header .sub-heading {
padding: 0px, 0px, 20px;
}
pre {
border: none;
background-color: #8acc37;

View File

@ -6720,11 +6720,15 @@ code {
}
.page-header {
margin: 10px 0px;
padding: 0px 0 20px;
padding: 0px;
}
.page-header h1 {
margin-top: 0px;
}
/* To be applied to the same element as page-header for sites that have sub-heading content such as Last modified time */
.page-header .sub-heading {
padding: 0px, 0px, 20px;
}
pre {
border: none;
background-color: #7795b4;

View File

@ -6720,11 +6720,15 @@ code {
}
.page-header {
margin: 10px 0px;
padding: 0px 0 20px;
padding: 0px;
}
.page-header h1 {
margin-top: 0px;
}
/* To be applied to the same element as page-header for sites that have sub-heading content such as Last modified time */
.page-header .sub-heading {
padding: 0px, 0px, 20px;
}
pre {
border: none;
background-color: #ecb5a1;

View File

@ -191,9 +191,29 @@ Set custom files and entire folders to ignore within your `/docs` folder. For fi
###Disabling clean URLs
By default, Daux.io will create clean url's that do not include index.php. On servers running Apache, uploading the included .htaccess file should be enough for them to work properly. On servers that are not running Apache or that do not allow custom .htaccess files, you may need to disable clean_urls:
```json
{
"clean_urls": false
}
```
###Date Modified
By default, daux.io will display the last modified time as reported by the system underneath the title for each document. To disable this, change the option in your config.json to false.
```json
{
"date_modified": false
}
```
###Timezone
If your server does not have a default timezone set in php.ini, it may return errors when it tries to generate the last modified date/time for docs. To fix these errors, specify a timezone in your config file. Valid options are available in the [PHP Manual](http://php.net/manual/en/timezones.php).
```json
{
"timezone": "America/Los_Angeles"
}
```
## Running Remotely
@ -214,6 +234,52 @@ The Grunt.js task uses the built in web server in PHP 5.4 to host the docs on yo
This project contains a package.json file, so once you have the requirements installed, you can simply run a `npm install` and then `grunt` in the projects folder to start the local web server. By default the server will run at: <a href="http://localhost:8085" target="_blank">http://localhost:8085</a>
## Running on IIS
If you have set up a local or remote IIS web site, you may need a `web.config` with:
* A rewrite configuration, for handling clean urls.
* A mime type handler for less files, if using a custom theme.
### Clean URLs
The `web.config` needs an entry for `<rewrite>` under `<system.webServer>`:
```xml
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Main Rule" stopProcessing="true">
<match url=".*" />
<conditions logicalGrouping="MatchAll">
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
</conditions>
<action type="Rewrite" url="index.php" appendQueryString="false" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
```
To use clean URLs on IIS 6, you will need to use a custom URL rewrite module, such as [URL Rewriter](http://urlrewriter.net/).
### Less Mime Type
The `web.config` needs a new `<mimeMap>` entry, under `<staticContent>` in `<system.webServer>`:
```xml
<staticContent>
<mimeMap fileExtension=".less" mimeType="text/css" />
</staticContent>
```
You will only need the mime map entry if you are using a custom theme and receive 404s for `.less` files.
If you have a global mime map entry for `.less` files set for the server, you will receive an internal server (500) error for having duplicate mime map entries.
## Support
If you need help using Daux.io, or have found a bug, please create an issue on the <a href="https://github.com/justinwalsh/daux.io/issues" target="_blank">GitHub repo</a>.

View File

@ -3,6 +3,7 @@
"tagline": "The Easiest Way To Document Your Project",
"image": "img/app.png",
"theme": "navy",
"date_modified": true,
"repo": "justinwalsh/daux.io",
"twitter": ["justin_walsh", "todaymade"],
"google_analytics": "UA-12653604-10",

View File

@ -70,6 +70,8 @@ $tree = get_tree("docs", $base_url);
$homepage_url = homepage_url($tree);
$docs_url = docs_url($tree);
$page = load_page($tree);
// If a timezone has been set in the config file, override the default PHP timezone for this application.
if(isset($options['timezone']))
{
@ -183,7 +185,7 @@ if ($homepage && $homepage_url !== '/') {
<div class="container">
<div class="row">
<div class="span10 offset1">
<?php echo load_page($tree); ?>
<?php echo $page['html'];?>
</div>
</div>
</div>
@ -265,7 +267,23 @@ if ($homepage && $homepage_url !== '/') {
<div class="right-column <?php echo ($options['float']?'float-view':''); ?> content-area span9">
<div class="content-page">
<article>
<?php echo load_page($tree); ?>
<?php if($options['date_modified'] && isset($page['modified'])) { ?>
<div class="page-header sub-header">
<h1><?php echo $page['title'];?></h1>
<span style="float: left; font-size: 10px; color: gray;">
<?php echo date("l, F j, Y", $page['modified']);?>
</span>
<span style="float: right; font-size: 10px; color: gray;">
<?php echo date ("g:i A", $page['modified']);?>
</span>
</div>
<?php } else { ?>
<div class="page-header">
<h1><?php echo $page['title'];?></h1>
</div>
<?php } ?>
<?php echo $page['html'];?>
</article>
</div>
</div>

View File

@ -474,10 +474,13 @@ code {
.page-header {
margin: 10px 0px;
padding: 0px 0 20px;
padding: 0px;
h1 {
margin-top: 0px;
}
sub-heading {
padding: 0px, 0px, 20px;
}
}
pre {
border: none;

View File

@ -1,6 +1,7 @@
<?php
ini_set('display_errors', 1);
error_reporting(E_ALL);
// Enable for debugging
// ini_set('display_errors', 1);
// error_reporting(E_ALL);
/*
* WARNING: DO NOT EDIT THIS FILE.
@ -34,6 +35,7 @@ function get_options() {
'tagline' => false,
'image' => false,
'theme' => 'blue',
'date_modified' => true,
'float' => true,
'repo' => false,
'twitter' => array(),
@ -102,28 +104,29 @@ function docs_url($tree, $branch = false) {
function load_page($tree) {
$branch = find_branch($tree);
$page = array();
if (isset($branch['type']) && $branch['type'] == 'file') {
$html = '';
if ($branch['name'] !== 'index') {
$html .= '<div class="page-header">';
$html .= '<h1>'. $branch['title'] . '</h1>';
// Show last modified time for docs. Needs to be cleaned up and use template colours.
$modified = filemtime($branch['path']);
$html .= '<span style="float: left; font-size: 10px; color: gray;">';
$html .= date ("l, F j, Y", $modified);
$html .= '</span><span style="float: right; font-size: 10px; color: gray;">';
$html .= date ("g:i A", $modified);
$html .= '</span>';
$html .= '</div>';
$page['title'] = $branch['title'];
$page['modified'] = filemtime($branch['path']);
}
$html .= MarkdownExtended(file_get_contents($branch['path']));
return $html;
$page['html'] = $html;
} else {
return "Oh No. That page dosn't exist";
$page['title'] = "Oh no";
$page['html'] = "<h3>Oh No. That page dosn't exist</h3>";
}
return $page;
}
function find_branch($tree) {