Skip to content

Commit eb06853

Browse files
committed
🎨 prettify the code
1 parent 1d55827 commit eb06853

File tree

13 files changed

+119
-137
lines changed

13 files changed

+119
-137
lines changed

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
name: Bug report
33
about: Create a report to help us improve
4-
title: ''
4+
title: ""
55
labels: bug
66
assignees: nelson6e65
7-
87
---
98

109
**Scopes**
10+
1111
- [ ] Installation
1212
- [ ] Documentation
1313
- [ ] Template (twig, xml)
@@ -17,13 +17,12 @@ assignees: nelson6e65
1717
- [ ] Appearance
1818
- [ ] Other
1919

20-
2120
**Describe the bug**
2221
A clear and concise description of what the bug is.
2322

24-
2523
**Steps to reproduce**
2624
Steps to reproduce the behavior:
25+
2726
1. Go to '...'
2827
2. Click on '....'
2928
3. Scroll down to '....'
@@ -36,16 +35,19 @@ A clear and concise description of what you expected to happen.
3635
If applicable, add screenshots to help explain your problem.
3736

3837
**Enviroment:**
39-
- **OS**: [e.g. Fedora 29, Windows 7, etc]
40-
- **Browser**: [e.g. chrome, safari]
38+
39+
- **OS**: [e.g. Fedora 29, Windows 7, etc]
40+
- **Browser**: [e.g. chrome, safari]
4141

4242
**Versions:**
43-
- **Template**:
44-
- PHP:
45-
- Node:
46-
- Yarn:
47-
- **VuePress**:
48-
- **phpDocumentor**:
43+
44+
- **Template**:
45+
- PHP:
46+
- Node:
47+
- Yarn:
48+
- **VuePress**:
49+
- **phpDocumentor**:
4950

5051
**Additional context**
52+
5153
<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/feature_request.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ name: Feature request
33
about: Suggest an idea for this project
44
title: "[feature] "
55
labels: enhancement
6-
assignees: ''
7-
6+
assignees: ""
87
---
98

109
**Scopes**
10+
1111
- [ ] Installation
1212
- [ ] Documentation
1313
- [ ] Template (twig, xml)
@@ -17,7 +17,6 @@ assignees: ''
1717
- [ ] Appearance
1818
- [ ] Other
1919

20-
2120
**Is your feature request related to a problem? Please describe.**
2221
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
2322

.github/ISSUE_TEMPLATE/question.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ name: Question
33
about: Questions about usage or misunderstood instructions.
44
title: "[question] How to ____?"
55
labels: question
6-
assignees: ''
7-
6+
assignees: ""
87
---
98

109
**Scopes**
10+
1111
- [ ] Installation
1212
- [ ] Documentation
1313
- [ ] Template (twig, xml)

.travis.yml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ php:
88
- 7.3
99

1010
cache:
11-
- npm
12-
- composer
11+
- npm
12+
- composer
1313

1414
env:
1515
global:
@@ -30,7 +30,6 @@ matrix:
3030
- php: 5.6
3131
- php: 7.0
3232

33-
3433
before_install:
3534
# Update composer
3635
- composer self-update

README.md

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
[![Card](./.github/assets/card.svg)](https://nelson6e65.github.io/phpdoc-vuepress)
22

33
# PHPDoc-VuePress
4+
45
[![Travis Build Status](https://img.shields.io/travis/nelson6e65/phpdoc-vuepress/master.svg?logo=travis)](https://travis-ci.org/nelson6e65/phpdoc-vuepress)
56
![PHP Versions](https://img.shields.io/travis/php-v/nelson6e65/phpdoc-vuepress.svg)
67

@@ -12,7 +13,6 @@
1213
[![Documentation](http://img.shields.io/badge/📜-Documentation-lightgrey.svg)](https://nelson6e65.github.io/phpdoc-vuepress)
1314
[![Wakatime](https://wakatime.com/badge/github/nelson6e65/phpdoc-vuepress.svg)](https://wakatime.com/badge/github/nelson6e65/phpdoc-vuepress)
1415

15-
1616
Template for generating your PHP API documentation in a pretty VuePress format.
1717

1818
This package provides a **phpDocumentor** template to generate the API documentation of your code to be integrated in a nice looking [VuePress](https://vuepress.vuejs.org) project.
@@ -30,7 +30,6 @@ This template will generate six VuePress `*.md` files with the DocBlock document
3030
- `constants.md`: Contains all global constants, sorted by namespace.
3131
- `functions.md`: Contains all global functions, sorted by namespace.
3232

33-
3433
## Demo
3534

3635
Check a demo of documentation generated with this template in http://nelson6e65.github.io/phpdoc-vuepress/demo/
@@ -39,7 +38,6 @@ Explore sources of [nelson6e65/phpdoc-vuepress](https://github.com/nelson6e65/ph
3938

4039
> A real project API generated using this template: [nelson6e65.github.io/php_nml/api/](https://nelson6e65.github.io/php_nml/api/).
4140
42-
4341
## Requirements
4442

4543
- PHP >= 5.6
@@ -61,29 +59,24 @@ composer require --dev nelson6e65/phpdoc-vuepress
6159

6260
> You may need to set the composer option [minimum-stability](https://getcomposer.org/doc/04-schema.md#minimum-stability) to 'dev' in order to be able to install pre-releases.
6361
64-
6562
## Usage
6663

6764
Run phpDocumentor and set template as `vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress`:
6865

69-
7066
```bash
7167
phpdoc -d="src/" -t="docs/api/" --template="vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress"
7268
```
7369

7470
> More information about the available arguments can be found at [running phpDocumentor](http://www.phpdoc.org/docs/latest/guides/running-phpdocumentor.html).
7571
76-
7772
## Configuration
7873

7974
See the [Configuration section in the documentation](https://nelson6e65.github.io/phpdoc-vuepress/guide/configuration.html) for setup examples.
8075

81-
8276
## Further reading
8377

8478
Check the documentation for more information [https://nelson6e65.github.io/phpdoc-vuepress/](https://nelson6e65.github.io/phpdoc-vuepress/).
8579

86-
8780
## License
8881

8982
[![License](https://img.shields.io/github/license/nelson6e65/phpdoc-vuepress.svg)](LICENSE)

composer.json

Lines changed: 45 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,48 @@
11
{
2-
"name": "nelson6e65/phpdoc-vuepress",
3-
"description": "Template for generating your PHP API documentation in a pretty VuePress format.",
4-
"keywords" : [ "PHPDoc", "PHP", "phpDocumentor", "Documentation", "Markdown", "VuePress" ],
5-
"homepage" : "https://github.com/nelson6e65/phpdoc-vuepress",
6-
"license": "MIT",
7-
"authors": [
8-
{
9-
"name": "Nelson Martell",
10-
"email": "nelson6e65@gmail.com"
11-
}
12-
],
13-
"autoload": {
14-
"psr-4": {
15-
"NelsonMartell\\VuePress\\": "src"
16-
}
2+
"name": "nelson6e65/phpdoc-vuepress",
3+
"description": "Template for generating your PHP API documentation in a pretty VuePress format.",
4+
"keywords": [
5+
"PHPDoc",
6+
"PHP",
7+
"phpDocumentor",
8+
"Documentation",
9+
"Markdown",
10+
"VuePress"
11+
],
12+
"homepage": "https://github.com/nelson6e65/phpdoc-vuepress",
13+
"license": "MIT",
14+
"authors": [
15+
{
16+
"name": "Nelson Martell",
17+
"email": "nelson6e65@gmail.com"
18+
}
19+
],
20+
"autoload": {
21+
"psr-4": {
22+
"NelsonMartell\\VuePress\\": "src"
23+
}
24+
},
25+
"require-dev": {
26+
"phpdocumentor/phpdocumentor": "^2.9",
27+
"jms/serializer": "1.7.*"
28+
},
29+
"autoload-dev": {
30+
"psr-4": {
31+
"NelsonMartell\\VuePress\\Demo\\": "demo"
1732
},
18-
"require-dev": {
19-
"phpdocumentor/phpdocumentor": "^2.9",
20-
"jms/serializer": "1.7.*"
21-
},
22-
"autoload-dev": {
23-
"psr-4": {
24-
"NelsonMartell\\VuePress\\Demo\\": "demo"
25-
},
26-
"files": [
27-
"demo/constants.php",
28-
"demo/functions.php"
29-
]
30-
},
31-
"scripts": {
32-
"build:api": [
33-
"phpdoc --ansi"
34-
]
35-
},
36-
"extra": {
37-
"branch-alias": {
38-
"dev-master": "1.0.x-dev"
39-
}
40-
}
33+
"files": [
34+
"demo/constants.php",
35+
"demo/functions.php"
36+
]
37+
},
38+
"scripts": {
39+
"build:api": [
40+
"phpdoc --ansi"
41+
]
42+
},
43+
"extra": {
44+
"branch-alias": {
45+
"dev-master": "1.0.x-dev"
46+
}
47+
}
4148
}

docs/.vuepress/config.js

Lines changed: 22 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,14 @@ module.exports = {
1212
description: 'Template for generating your PHP API documentation in a pretty VuePress format',
1313

1414
head: [
15-
['link', { rel: 'icon', href: '/favicon.svg' }] // Custom favicon
15+
['link', { rel: 'icon', href: '/favicon.svg' }], // Custom favicon
1616
],
1717

1818
// Plugins config
1919
plugins: {
2020
'@vuepress/google-analytics': {
21-
ga: 'UA-58599811-1' // GoogleAnalytics ID (optional. use your own ga)
22-
}
21+
ga: 'UA-58599811-1', // GoogleAnalytics ID (optional. use your own ga)
22+
},
2323
},
2424

2525
themeConfig: {
@@ -29,16 +29,18 @@ module.exports = {
2929
],
3030

3131
sidebar: {
32-
'/guide/': [ // Normal documentation sidebar
32+
'/guide/': [
33+
// Normal documentation sidebar
3334
{
3435
title: 'Guide',
3536
collapsable: false,
36-
children: [ // Normal pages
37+
children: [
38+
// Normal pages
3739
'',
3840
'getting-started',
3941
'configuration',
40-
]
41-
}
42+
],
43+
},
4244
],
4345

4446
// Your API documentation sidebar
@@ -49,22 +51,20 @@ module.exports = {
4951
{
5052
title: 'API Demo',
5153
collapsable: false,
52-
children: [ //
54+
children: [
55+
//
5356
'', // Ref. to the `README.md` file
5457
'classes', // Ref. to the `classes.md` file
5558
'interfaces', // Ref. to the `interfaces.md` file
5659
'traits', // Ref. to the `traits.md` file
5760
'functions', // Ref. to the `functions.md` file
58-
'constants' // Ref. to the `constants.md` file
59-
]
60-
}
61+
'constants', // Ref. to the `constants.md` file
62+
],
63+
},
6164
],
62-
'/': [
63-
''
64-
]
65+
'/': [''],
6566
},
6667

67-
6868
// You can ignore the following optional customizations --------------------
6969

7070
markdown: {
@@ -87,9 +87,10 @@ module.exports = {
8787
// custom webpack configuration
8888
configureWebpack: {
8989
resolve: {
90-
alias: { // Aliases
91-
'@github': '../../.github/assets'
92-
}
93-
}
94-
}
95-
}
90+
alias: {
91+
// Aliases
92+
'@github': '../../.github/assets',
93+
},
94+
},
95+
},
96+
};

docs/README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,15 @@ actionLink: /guide/
99
footer: MIT Licensed | Copyright © 2018-2020 Nelson Martell
1010

1111
features:
12-
- title: Document all your code
13-
details: Generate documentation for all your classes, interfaces and traits sorted by namespace. Also, include your global/namespaced functions and constants.
12+
- title: Document all your code
13+
details: Generate documentation for all your classes, interfaces and traits sorted by namespace. Also, include your global/namespaced functions and constants.
1414

15-
- title: Easy integration
16-
details: Combine your API documentation with your existent VuePress pages by simply adding the 5 generated files to your sidebar configuration as a group.
15+
- title: Easy integration
16+
details: Combine your API documentation with your existent VuePress pages by simply adding the 5 generated files to your sidebar configuration as a group.
1717

18-
- title: Linked references
19-
details: Navigate between classes/members references by just a click. Get references of inherited members
18+
- title: Linked references
19+
details: Navigate between classes/members references by just a click. Get references of inherited members
2020

21-
- title: Searchable elements
22-
details: Use the VuePress search in toolbar to find classes, interfaces, traits, functions and constants by name.
21+
- title: Searchable elements
22+
details: Use the VuePress search in toolbar to find classes, interfaces, traits, functions and constants by name.
2323
---

0 commit comments

Comments
 (0)