Update readme.md

This commit is contained in:
4rkal 2023-09-01 11:55:31 +03:00 committed by GitHub
parent 1359dafc39
commit a8be3124ba
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,52 +1,22 @@
## About
Emerald is a minimal theme created for Jekyll. The main purpose of Emerald is to provide a clear theme for those who want a blog ready to use, focused on the content and mobile-first.
![Emerald](/img/Emerald01.png "Emerald")
[Emerald](https://github.com/KingFelix/emerald/) is the theme used by revuo-xmr. It is a minimal and mobile-first blog theme for Jekyll.
## Setup & usage
Emerald may be installed by simply downloading the .zip folder from the [repository on Github](https://github.com/KingFelix/emerald/archive/master.zip).
To setup emerald you have to follow the steps bellow
After extracting the content from the folder into the selected directory, you can type ``jekyll serve`` from the terminal, than open your browser to ``0.0.0.0:4000/emerald/`` and you will find it there.
Install ruby from [here](https://www.ruby-lang.org/en/)
Additionally it is possible to fork the repository and use Github Pages as hosting. By following this way it will be enough to change the ``baseurl`` value into the ``_config.yml`` file, with the directory name of your project (for example /blog) or simply with a "/" (slash) if you want install Emerald in the root.
Now run the following commands:
### Options
Starting from the 1.1.0 version, you can customize Emerald thanks to a few options. Now it is possible to set a custom header tag by setting the related option in the ``_config.yml`` file to "true". Then insert your custom code into the ``header-custom.html`` file.
In the same way, you can customize the footer of the navigation menu, by setting to "true" the related option and put your code into the ``nav-footer-custom.html`` file.
Moreover it is now possible to select a reverse option that allows to move the navigation menu to the left side, by setting it to "true".
`gem install bundler jekyll` (installs jekyll and bundler)
### Colors
The basic colors are set into the ``base.scss`` file:
- $main-color: used for the menu, title, link and footer
- $background-color: used for background and links in the navigation menu
- $text-color: used for text and title in posts and pages
`git clone https://github.com/rottenwheel/revuo-weekly` (clone the repo)
To customize the colors, just set the values in HEX, RGB (or RGBa) or any other format accepted by CSS.
`cd revuo-weekly`
### Navigation menu
Starting from the 1.1.0 version, the links inside the navigation menu are autogenerated from pages having the layout set to ``page``.
You can set custom links, by putting in the ``<a>`` tag into the ``link.html`` file.
`bundle exec jekyll serve` (serve the website)
### Branch
Emerald has two branch:
- ``master``: is for developing pourpose.
- ``gh-pages``: is only for demo site.
### Baseurl
Emerald was thought to be used mainly with Github, in particular into [project site](https://pages.github.com/). For this reason several tags have been included ``{{ site.baseurl }}`` to refer to the "/emerald/" directory.
You can change the "baseurl" value into the ``config.yml`` file, to match your directory (for example "/blog/") or the root of your project. In that case you must set the "baseurl" value to "/".
### Typography
To maintain the vertical rhythm, it has been applied a **Typographic scale** as a modular scale, with a baseline set to 24px. To maintain this rhythm you need to insert elements like image, video or other contents with a 24px (or multiple) height as refer.
Last but not least: the [Jekyll documentation](http://jekyllrb.com) is the best starting point!
## Author
### Jacopo Rabolini
- Web site: [www.jacoporabolini.com](http://www.jacoporabolini.com)
- Google+: [+JacopoRabolini](https://plus.google.com/u/0/+JacopoRabolini/posts)
If you open your web-browser to `http://127.0.0.1:4000/` you should see revuo up and running.
## License
Emerald is released under [MIT License](license.md).