- Ruby >= 2.5.0
$ gem install miyano
$ cd ~/Document( any place you prefer )
- Create a new blog depends on your markup language
For Default Polar Bear Markup Language
$ miyano new myblog
For Markdown Compatibility Mode
$ miyano new myblog -m
myblog is a directory you want to create )
$ cd myblog
[myblog]$ miyano build
[myblog]$ miyano try
- open Browser and go to
Ctrl + Cto quit
├── layout │── ├── default.scss │── ├── index.html.erb │── └── post.html.erb └── post ├── *.bearnote
post/ directory is the place where you export you
layout/ directory contains the template files that control the way your blog looks.
read more about template on wiki page
Export Your Bear Notes
how to export
Export your notes - Bear - Faq and support
- In Bear App => File => Export Notes
- Export as Bear Note
What is the Export attachments option ?
>This option uses for other filetypes which cannot pack pictures or files. The Bear Note will take good care of all your files and pictures, so you don't need to worry about this option.
You can keep the default name of your bear note, and also can change whatever name you prefer.
The name of the bear note will be the part of the URL of your blog.
foo bar.bearnote -> site.com/foo%20bar/ foo_bar.bearnote -> site.com/foo_bar/
The Space in the filename will be translated to
%20 in the URL.
If you don't like the
%20 in the URL, change the
If there's a page you want to share with others, then keeping the URL clear and meaningful is important.
By the way, you don't need to change the name every time you export the notes which will make you complex and trouble.
When you create a note in Bear App, it has a
create_date. Every time you edit it, the
The date information keeps after you export them.
So you don't worry about the date.
copying bearnotes in terminal
cp -p , the
-p option will keep the date information, or you will lose all your date information.
The Bear Note will pack all of your attachments ( pictures, files, sketches) , and Miyano will unpack and put them in the right place.
Never worry about the files!
Deploy your blog on the Internet for free and stable.
- A Github Account
- Create a User Pages site, name the repository using the naming scheme:
Just for your information:
User, Organization, and Project Pages
Not Support Project Pages
$ cd path/to/myblog
[myblog]$ miyano push
push cmd contains the
build cmd )
If you are at the first time, the cmd will ask you for the Github Page's repo URL.
If you do not use git before, the username and password will be asked by git (not miyano).
CNAME - Use your own domain
[myblog]$ echo "example.com" > _site/CNAME
Create CNAME at local to avoid git conflict
Using a custom domain with GitHub Pages
Recommend Free CDN Service
Just Miyano Tip
Specify your blog's root address and Save your time.
If you like miyano, and decide to use it for a long time.
This little trick will save you much time.
And the update action will not be so annoying.
$ cd path/to/myblog
[myblog]$ pwd > ~/.miyano
After that, whenever you want to do a update, open the terminal and type
miyano, press Enter, done.
Because your root of your blog already had be specified, you don't need to care about the current directory of the terminal any more.
Bugs & Need Help?
Bear - Faq and support - Recommend
Bear - Twitter
Bear - Reddit
Bear - Contact by email
FAQ · wuusn/miyano Wiki · GitHub
You are my special,
Just contact me.
Join Telegram Group @M1yano
PM to me @o1chi
mail me: [email protected]
Source Code on Github
Give a Star ★ to support me!
Who is Miyano? ⬇️
“TRY~ ME~” she says.
#github #tips #blog #tech #ruby