This repository has been archived on 2022-11-29. You can view files and clone it, but cannot push or open issues or pull requests.
socialtree-jigsaw/README.md
2022-05-03 13:41:45 +02:00

50 lines
1.8 KiB
Markdown

# 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](examples/images/main.png)
- [blurywhite](examples/images/blurywhite.png)
- 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:
- YouTube, Pinterest, Twitter, TikTok, Telegram, Linkedin, Mastodon, Tumblr,
Discord, Twitch, Instagram, Flickr, Deviantart, Spotify, Snapchat, Reddit,
Soundcloud, VK, Steam
- 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
- 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/