English | العربية

The Simple Arabic Theme 🌘

My innocent try to make the world a better place for people like me (simple humans who love the Arabic Language) 🌱

✨ How to use ?

1. Make a git repo with your username like this {username}.github.io (Do not add description or .gitignore or any files in the repo).
2. Clone the repo into a folder of your choice using git clone
3. Open a command line inside the repo folder
4. Add remote upstream using the following command git remote add upstream git@github.com:MohamedAliRashad/The-Simple-Arabic-Theme.git
5. Pull the theme stable code using git pull upstream main
6. Merge the code pulled with your main branch using git merge upstream/main --allow-unrelated-histories
7. Open any text editor and change the following in _config.yml
   • baseurl from /The-Simple-Arabic-Theme to empty string or /blog if you want some customization (doesn't recommend it, if you don't know what you are doing)
   • url from https://mohamedalirashad.github.io to the gh-pages url (you should only change the username in the link with the username in step 1)
   • favicon /The-Simple-Arabic-Theme/assets/images/moon.svg to /assets/images/moon.svg (if you changed the base url to something other than an empty string, you will need to add it in the begging)

And that's it, Just push the changes to your github repo and start building content 🎉

📰 News

News has moved to Here (To make the README static from here on out).

✏️ How to make a post ?

1. Run this command in a terminal opened in the repo

   bundle exec jekyll serve --livereload
   

2. Go to the link printed after Server address: (ctrl+click to open in Linux)
3. From the page that will be opened choose the tab اصنع محتوى and start making your content.
4. After finishing, Just download the post (using the تفريغ button) to the _posts folder
5. Make any last changes into it (you should see the post in the home page of livereload page).
6. Finally, Upload the post using git add, git commit and git push (or just use the sync functionality in vscode)

💡 Awesome Blogs

Awesome Blogs has moved to Here (To make the README static from here on out).

✋ Why i made it ?

I am a researcher who enjoys reading and learning new stuff from time to time. what I discovered through my days of learning was the superficiality of understanding I had in topics I thought I knew well.

The event that opened my eyes to a new way of learning was when I translated a famous concept I thought I understood well into Arabic and gave myself some time to digest it to find out that I reached a new level of understanding I haven't gone before. All of this, was just because I translated the definition into my mother tongue and gave myself the chance to connect more dots in my brain.

After this incident, i started to translate everything into Arabic and read it again to not just understand the idea, but also the philosophy behind it. And the journey so far was amazing that's why I have wanted to do this project for some time. I want others like me to learn and understand using content written in their mother language and to write about themselves, their ideas, and their theories about the world in motion.

👷 Wants to contribute ?

Contribution tutorials has moved to Here (To make the README static from here on out).