Skip to content

Commit 1e9fb19

Browse files
committed
Installation and static generation
1 parent 5067a76 commit 1e9fb19

File tree

15 files changed

+9676
-36
lines changed

15 files changed

+9676
-36
lines changed

.gitignore

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
.picasa.ini
44
.viminfo
55
vendor/
6-
www/temp/
7-
FileManager.json
86
*.cache
7+
*.bat
98
phpunit.xml
109

10+

.php_cs.dist

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?php
22

33
$finder = PhpCsFixer\Finder::create()
4-
->in(__DIR__.'\PHPFUI\InstaDoc')
4+
->in(__DIR__.'/src/PHPFUI/InstaDoc')
55
;
66

77
return PhpCsFixer\Config::create()

README.md

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,27 @@
44

55
We all document our code with PHP [DocBlocks](https://en.wikipedia.org/wiki/PHPDoc) but we never seem to actually generate the documentation and add it to our project. Why? It simply takes too much time (over a minute), so we put it off till later, and later never comes.
66

7-
But with PHPFUI\InstaDoc, you can document your site in about a minute (OK, maybe 5). The steps involved:
8-
* Install PHPFUI\InstaDoc via Composer
9-
* Run installation script
10-
* Create document page
7+
But with PHPFUI\InstaDoc, you can document your site in about a minute (OK, maybe 2). The steps involved:
8+
* Install PHPFUI\InstaDoc via Composer (30 seconds)
9+
* Run installation script (30 seconds)
10+
* Create document page (1 minute, 4 lines of code)
11+
12+
Two minutes to usable documentation with the following features:
13+
14+
## PHPFUI\InstaDoc Features
15+
* Always up to date, even with code that is not yet checked in
16+
* Documents all projects loaded via Composer automatically
17+
* Add any local repo directories
18+
* Remove any Composer project you don't care about
19+
* Custom ordering of types (const, static, public, protected, etc.)
20+
* Alphabetized everything, no more searching unalphabetized pages!
21+
* Support for markdown and custom markdown pages
22+
* Quick access to highlighed PHP source with user selectable highlighting
23+
* Quick access to the file's git history for the local repo
24+
* Ability to generate static html files for high volume sites
25+
* 4+ line config compatible with all PHP frameworks, or standalone
26+
* Completely configureable UI if you don't like the default
27+
* Uses [Foundation CSS framework](https://get.foundation) for a great experience on mobile
1128

1229
### Install PHPFUI\InstaDoc
1330
composer require phpfui/InstaDoc
@@ -17,7 +34,7 @@ Once installed, you need to run an installation script to copy static files to t
1734

1835
php vendor/phpfui/InstaDoc/install.php yourPublicDirectory/subDirectory
1936

20-
Example: php vendor/phpfui/InstaDoc/install.php public/PHPFUI will add all needed files to public/PHPFUI, which will avoid any conflicts with your current files. You can specify any directory, but PHPFUI is recomended to keep things simple.
37+
Example: php vendor/phpfui/instadoc/install.php public/PHPFUI will add all needed files to public/PHPFUI, which will avoid any conflicts with your current files. You can specify any directory, but PHPFUI is recomended to keep things simple.
2138

2239
### Create Document Page
2340
PHPFUI\InstaDoc does not reply on any framework and can run on a standalone page. It is recommended that you do not make your documentation public, as PHPFUI\InstaDoc will display PHP source files. How you restrict access to the page is up to you. The following does not restrict access and is simply an example:
@@ -35,9 +52,7 @@ That is it. You are done!
3552

3653
#### To Do List:
3754

38-
* Generate static files
3955
* Create Doc page (the whole point, but do the easy stuff first!)
40-
* Add installation script
4156
* Add more documentation
4257
* Allow for customizable pages (not 100% yet)
4358
* .git page

codestyle.bat

Lines changed: 0 additions & 5 deletions
This file was deleted.

0 commit comments

Comments
 (0)