Skip to content

Commit 40d2f80

Browse files
committed
🎨 Improve documentation with some logos
1 parent 1ca1dd7 commit 40d2f80

File tree

8 files changed

+576
-10
lines changed

8 files changed

+576
-10
lines changed

.github/assets/card.svg

Lines changed: 228 additions & 0 deletions
Loading

README.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
# phpDocumentor VuePress template
1+
![Card](.github/card.svg)
2+
3+
# PHPDoc-VuePress
24
[![Travis Build Status](https://img.shields.io/travis/nelson6e65/phpdoc-vuepress/master.svg?logo=travis)](https://travis-ci.org/nelson6e65/phpdoc-vuepress)
35
![PHP Versions](https://img.shields.io/travis/php-v/nelson6e65/phpdoc-vuepress.svg)
46

@@ -13,7 +15,7 @@
1315

1416
Template for generating your PHP API documentation in a pretty VuePress format.
1517

16-
This package provides a **phpDocumentor** template to generates the API documentation of your code to be integrated in a nice looking [VuePress](https://vuepress.vuejs.org) project.
18+
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.
1719

1820
> Only tested with the default theme of VuePress.
1921
@@ -56,7 +58,7 @@ Install `nelson6e65/phpdoc-vuepress` with composer:
5658
```bash
5759
composer require --dev nelson6e65/phpdoc-vuepress
5860
```
59-
61+
6062
> 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.
6163
6264

@@ -86,7 +88,7 @@ Check the documentation for more information [https://nelson6e65.github.io/phpdo
8688

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

89-
Copyright (c) 2018-2019 Nelson Martell
91+
Copyright (c) 2018-2020 Nelson Martell
9092

9193
Read the [`LICENSE` file](LICENSE) for details.
9294

docs/.vuepress/config.js

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,15 @@ module.exports = {
66
base: '/phpdoc-vuepress/',
77

88
// Title of your project
9-
title: 'phpdoc-vuepress',
9+
title: 'PHPDoc-VuePress',
1010

1111
// Description of your project
1212
description: 'Template for generating your PHP API documentation in a pretty VuePress format',
1313

14+
head: [
15+
['link', { rel: 'icon', href: '/favicon.svg' }] // Custom favicon
16+
],
17+
1418
// Plugins config
1519
plugins: {
1620
'@vuepress/google-analytics': {
@@ -78,5 +82,14 @@ module.exports = {
7882
repo: 'nelson6e65/phpdoc-vuepress',
7983
docsDir: 'docs',
8084
editLinks: true,
85+
},
86+
87+
// custom webpack configuration
88+
configureWebpack: {
89+
resolve: {
90+
alias: { // Aliases
91+
'@github': '../../.github/assets'
92+
}
93+
}
8194
}
8295
}

docs/.vuepress/public/favicon.svg

Lines changed: 156 additions & 0 deletions
Loading

docs/.vuepress/public/hero.svg

Lines changed: 163 additions & 0 deletions
Loading

docs/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
home: true
3-
heroText: "phpdoc-vuepress"
3+
heroText: PHPDoc-VuePress
4+
heroImage: /hero.svg
45
tagline: Template for generating your PHP API documentation in a pretty VuePress format
56
actionText: Get Started →
67
actionLink: /guide/
78

8-
footer: MIT Licensed | Copyright © 2018-2019 Nelson Martell
9+
footer: MIT Licensed | Copyright © 2018-2020 Nelson Martell
910

1011
features:
1112
- title: Document all your code

docs/guide/README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
2+
![Card](~@github/card.svg)
3+
14
# Introduction
25

36
![GitHub release](https://img.shields.io/github/tag/nelson6e65/phpdoc-vuepress.svg?logo=github)
@@ -6,11 +9,11 @@
69

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

9-
::: tip phpdoc-vuepress
12+
::: tip PHPDoc-VuePress
1013
Template for generating your PHP API documentation in a pretty VuePress format.
1114
:::
1215

13-
This package provides a **phpDocumentor** template to generates the API documentation of your code to be integrated in a nice looking [VuePress](https://vuepress.vuejs.org) project.
16+
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.
1417

1518
> Only tested with the default theme of VuePress.
1619

docs/guide/configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ You need to tell phpDocumentor (1) where are your PHP source files, (2) where to
99
In order to accomplish this, you must create a configuration file named `phpdoc.dist.xml` and setup (1, 2, and 3).
1010

1111
:::tip Template location [3]
12-
If you installed via Composer, the template will be `vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress`.
12+
If you installed via Composer, the template will be located at `vendor/nelson6e65/phpdoc-vuepress/data/templates/vuepress` directory.
1313

1414
```xml
1515
<transformations>

0 commit comments

Comments
 (0)