Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Themes Documentation page update #46

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Themes Documentation page update #46

wants to merge 3 commits into from

Conversation

NyamiDev
Copy link

Hi, I want to update the following page to help others:
https://github.com/bludit/documentation-english/blob/master/pages/getting-started/themes/index.md

Updates to come, just learning this proces...

@NyamiDev
Copy link
Author

Themes

Bludit supports themes to change the appearance of your website or blog.

You can find themes on the Bludit Themes website.
How to install a theme

Download the zip file with the theme.
Uncompress the zip file.
Copy the theme folder into the folder /bl-themes/ on the server.

Go to the Admin panel, and on the left sidebar go to Settings > Themes.
Look for the theme in the list, and click on Activate.

====CHANGES====
Steps to actually copy the theme folder into the folder /bl-themes/ on the server.
If using a Virtual Private Server (VPS) try the following steps:

  1. You will need to have the ability to SSH into your server, so test this first. This is normally done from the terminal with the command "ssh admin@1.2.3.4". Then you will need to enter your password. If this works proceed to step 2, otherwise go through your VPS/server documentation and setup SSH first.
  2. Open up a new tab in your terminal. In this new tab you can then use the SCP command to transfer a file from your local system to your VPS on which you host your Bludit instance. SCP is part of SSH so as long as the step above worked you should be able to use SCP to make the file transfer from the computer where you downloaded the theme to your server.
  3. Use the command scp [source] [destination], where source in this case is your local computer and destination is your server. An example: “scp darktheme.zip admin@1.2.3.4:/home”
  4. If this worked the file will now be on your server.
  5. You now need to go back to the tab where you used ssh to get into your server. In your home directory use the ls command to see if your theme.zip file made it in. If so, go to step 6.
  6. You now need to find where in your directory structure the "bl-themes" folder is. You can use the following command to find it "sudo find / -type d -name "bl-themes". Once you have located it you can copy the file to this directory.
  7. You need to use the cp (copy command). "cp [source] [destination]", an example here: "cp /home/theme.zip /var/www/bludit/bl-themes"
  8. If you get “permission denied” you may need to do this as root. Root is a higher level of privilege if you like. To do this use “sudo su”.
  9. From this new prompt the cp command should work. You may need to adjust the source and destination text to get it right.
  10. Finally unzip the file. From the bl-themes directory, run "unzip theme.zip". This should decompress and install the files in the correct directory structure.
  11. This took me several hours to work out so I hope this helps speed the process up for you.

=====END====

@NyamiDev
Copy link
Author

Hi, please advise on formatting etc. Bludit is great but some of the instructions assume significant knowledge from the user. I hope this helps and thanks for the platform.

@NyamiDev NyamiDev marked this pull request as ready for review January 31, 2022 11:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
2 participants