Add README.md

This commit is contained in:
Nikurasu 2022-04-30 14:57:50 +02:00
parent de24810875
commit ded6dcf98e
3 changed files with 48 additions and 1 deletions

2
.gitignore vendored
View file

@ -9,4 +9,4 @@ npm-debug.log
/composer.lock /composer.lock
/build_production/ /build_production/
/build_staging/ /build_staging/
/source/assets/ /source/assets/build

47
README.md Normal file
View 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/

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB