Add README.md
This commit is contained in:
parent
de24810875
commit
ded6dcf98e
3 changed files with 48 additions and 1 deletions
2
.gitignore
vendored
2
.gitignore
vendored
|
@ -9,4 +9,4 @@ npm-debug.log
|
|||
/composer.lock
|
||||
/build_production/
|
||||
/build_staging/
|
||||
/source/assets/
|
||||
/source/assets/build
|
||||
|
|
47
README.md
Normal file
47
README.md
Normal file
|
@ -0,0 +1,47 @@
|
|||
# SocialTree
|
||||
|
||||
*A simple way to show your links*
|
||||
|
||||
---
|
||||
|
||||
This is a very simple static site generator for listing the links for your
|
||||
social media channels.
|
||||
|
||||
## Sounds great but how do I use it?
|
||||
|
||||
It's very simple, follow these steps.
|
||||
1. Install PHP and Node.js
|
||||
2. Download the Project as zip or clone it
|
||||
3. Run `composer install` and `npm install`
|
||||
4. Edit the `config.php` file:
|
||||
- The `author` is the displayed name
|
||||
- The `imageName` should be the file name of the image you are using, the
|
||||
file itself should be placed in `source/assets/images`
|
||||
- The `design` refers to the style of your page the currently available styles are:
|
||||
- main
|
||||
- List as much links as you like in the `links` array:
|
||||
- With the `color` property you can give the link the color of the social
|
||||
media plaform of your choice, but this feature is optional, the link will
|
||||
be displayed in the themes color if unset. The currently supported platforms
|
||||
are:
|
||||
- None, I will implement this feature in a future release
|
||||
- Place the link in the `link` property, this property is needed.
|
||||
- You can give the link a different text if you want with the `text` property.
|
||||
This is also optional.
|
||||
- Set the platform in the `platform` property, this will be displayed if the
|
||||
`name` is unset.
|
||||
5. Compile the page with the command: `npm run prod`
|
||||
6. Copy the `build_production` directory to your webserver.
|
||||
|
||||
---
|
||||
|
||||
# @TODO
|
||||
|
||||
- Different colors for different social media platforms
|
||||
- More themes
|
||||
|
||||
---
|
||||
|
||||
example.jpg by Yaka Bagus from Pexels:
|
||||
|
||||
https://www.pexels.com/photo/woman-in-costume-holding-a-swim-ring-while-standing-on-wooden-dock-9692281/
|
BIN
source/assets/images/example.jpg
Normal file
BIN
source/assets/images/example.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 88 KiB |
Reference in a new issue