jekyll-theme-mehdix-rtl 4.0.0 → 4.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +70 -21
- data/_includes/comment.html +5 -1
- data/assets/pimg/ghpages1.png +0 -0
- data/assets/pimg/ghpages2.png +0 -0
- data/assets/pimg/ghpages3.png +0 -0
- data/feed.xml +3 -3
- metadata +5 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: e8ed730348e727ab3a28bffb03afe744cde3e219b6394a2b14e141c1c3509326
|
|
4
|
+
data.tar.gz: e248002f9ba1de25d76a7078f3216a683a652de784ed478e5169c81935b6710a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: f2b3806da341942d15e489f9084313aac0061837090ca26afd677bff0523d98951360e93ca9a651bd23afec7222c7e74d9352c70c48676fc5e924efb910c9a01
|
|
7
|
+
data.tar.gz: b3cf383ec3f11fa5685d166294da42daa65808a3234ba89fbf157f7b6022e63751e201f275da063baf54a4546c5be2a8b9a5c5db0990232313ee422973947525
|
data/README.md
CHANGED
|
@@ -1,8 +1,70 @@
|
|
|
1
|
-
# jekyll-theme-mehdix-rtl [](https://badge.fury.io/rb/jekyll-theme-mehdix-rtl)
|
|
2
|
-
[](https://app.netlify.com/start/deploy?repository=https://github.com/mehdisadeghi/jekyll-theme-mehdix-rtl)
|
|
1
|
+
# jekyll-theme-mehdix-rtl [](https://badge.fury.io/rb/jekyll-theme-mehdix-rtl) [](https://app.netlify.com/start/deploy?repository=https://github.com/mehdisadeghi/jekyll-theme-mehdix-rtl)
|
|
3
2
|
|
|
4
|
-
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="screenshot.png">
|
|
5
|
+
</p>
|
|
5
6
|
|
|
7
|
+
See English version below.
|
|
8
|
+
|
|
9
|
+
<div dir="rtl" lang="fa">
|
|
10
|
+
این ریپازیتوری حاوی قالبی جکیلی است که برای [وبسایت شخصی](https://mehdix.ir) خودم ساخته‌ام. انگیزه ایجاد آن هم کمک به افرادی است که سعی دارند سایتی شبیه آن برای خودشان بسازند و پاسخ به سوالاتی است که طی سالهای گذشته در مورد نحوه ساخت آن پیوسته دریافت کرده‌ام. در ادامه روش‌های استفاده و سوالات رایج را می‌آورم. در راهنمای انگلیسی هم نحوه نصب را نوشته‌ام.
|
|
11
|
+
|
|
12
|
+
## نحوه استفاده
|
|
13
|
+
این ریپازیتوری را به دو طریق می‌توانید استفاده کنید. روش اول اینست که مستقیما این ریپازیتوری را فورک کنید. روش دوم استفاده از [جم روبی](https://rubygems.org/gems/jekyll-theme-mehdix-rtl) این قالب است. هر دو را شرح می‌دهم.
|
|
14
|
+
|
|
15
|
+
### استفاده به روش فورک
|
|
16
|
+
فورک کنید و بعد کلون کنید و اسم و رسم سایت و محتوا را تغییر بدهید و به عنوان یک سایت جدید استفاده کنید. در این روش باید بعد از فورک در ریپازیتوری جدید داخل اکانت خودتان GitHub Pages را فعال کنید و برنج _gp-pages_ را بعنوان برنچ حاوی سایت استاتیک انتخاب کنید (جایی که خروجی بیلد جکیل قرار دارد).
|
|
17
|
+
|
|
18
|
+
<p align="center">
|
|
19
|
+
<img src="assets/pimg/ghpages1.png">
|
|
20
|
+
</p>
|
|
21
|
+
|
|
22
|
+
بدون هیچ تغییر دیگری همینکه تغییرات خودتان را پوش کنید سایت بیلد می‌شود اما در _gp-pages_ کپی نمی‌شود. علت هم نقص در گیت‌هاب است چون امکان بیلد را ماکروسافت اخیرا بعد از خریداری گیت‌هاب اضافه کرده است و هنوز در حال تکمیل است. راه حلی که پیدا کردم استفاده از یک کلید جداگانه برای بیلد است. برای اینکار باید یک کلید روی کامپیوترتان بسازید و به تنظیمات ریپازیتوری گیت‌هابتان اضافه کنید. اول کلید را بسازید:
|
|
23
|
+
|
|
24
|
+
<div dir="ltr">
|
|
25
|
+
$ ssh-keygen -t rsa -b 4096 -C "$(git config user.email)" -f gh-pages -N ""
|
|
26
|
+
</div>
|
|
27
|
+
|
|
28
|
+
خروجی این دستور دو فایل `gh-pages` و `gh-pages.pub` است که اولی کلید خصوصی و دومی کلید عمومی است. بروید به _Settings/Deploy Keys_ و یک کلید جدید بنام `ACTIONS_DEPLOY_KEY` بسازید و محتوای فایل کلید عمومی را آنجا کپی کنید. اسم همین باشد چون در تنظیمات بیلد بکار رفته است. چک‌باکس _Allow write access_ را هم تیک بزنید.
|
|
29
|
+
|
|
30
|
+
<p align="center">
|
|
31
|
+
<img src="assets/pimg/ghpages2.png">
|
|
32
|
+
</p>
|
|
33
|
+
|
|
34
|
+
همینکار را هم برای کلید خصوصی در بخش _Secrets_ انجام بدهید و تمام.
|
|
35
|
+
|
|
36
|
+
<p align="center">
|
|
37
|
+
<img src="assets/pimg/ghpages3.png">
|
|
38
|
+
</p>
|
|
39
|
+
|
|
40
|
+
حسن این روش اینست که ساده و سرراست است. لازم نیست با پیچیدگی‌های جکیل و تنظیمات قالب را بدانید. عیبش هم اینست که تغییرات جدید در تم را دریافت نمی‌کند که به نظرم اهمیت چندانی ندارد.
|
|
41
|
+
|
|
42
|
+
### استفاده از طریق روبی جم
|
|
43
|
+
ساختار جکیل بکار رفته در این ریپازیتوری به صورت یک [جم روبی](https://rubygems.org/gems/jekyll-theme-mehdix-rtl) در دسترسی است. در اینصورت باید یک وبسایت جکیل ساخت و در فایل `_config.yml` قالب را تغییر داد. این کاری است که در ریپازیتوری [وبسایت خودم](https://github.com/mehdisadeghi/mehdix.ir/blob/master/_config.yml#L26) انجام داده‌ام. این روش را در شرح انگلیسی نوشته‌ام.
|
|
44
|
+
|
|
45
|
+
حسن این روش اینست که می‌توان نسخه‌های جدیدتر تم را به صورت نصب نسخه‌های جدیتر جم روبی دریافت کرد. عیبش آنست که قالب جکیل به صورت تم محدود است. مثلا جکیل صفحه ۴۰۴ را از داخل جم قالب نمی‌خواند، همینطور برخی فایل‌ها مانند فایل‌های تولید فید را. در ضمن باید تمام تنظیمات بیلد سایت را هم جداگانه انجام داد.
|
|
46
|
+
|
|
47
|
+
## برخی سوالات رایج
|
|
48
|
+
|
|
49
|
+
1. تقویم شمسی روی گیت‌هاب کار نمی‌کنه. پلاگین‌ها کار نمی‌کنند!
|
|
50
|
+
|
|
51
|
+
بیلدر پیش‌فرض گیت‌هاب نمی‌تواند این سایت را بیلد کند چون پلاگین‌ها را ندارد. از [تنظیمات بیلد](https://github.com/mehdisadeghi/jekyll-theme-mehdix-rtl/blob/master/.github/workflows/gh-pages.yml) همین وبسایت استفاده کنید که بالاتر شرح دادم.
|
|
52
|
+
|
|
53
|
+
2. وبسایت اصلا روی گیت‌هاب کار نمی‌کند! گیت‌هاب برنج gh-pages را اصلا برای وبسایت بکار نمی‌برد!
|
|
54
|
+
|
|
55
|
+
اگر اسم ریپازیتوری همان یوزرنیم شما باشد گیت‌هاب سایت را از برنج مستر خواهد ساخت. گیت‌هاب به این سایت‌ها User page می‌گوید و در غیر اینصورت Project page. روش‌هایی که برای بیلد توضیح دادم فقط برای Project page کار می‌کند. یعنی یوزرنیم و نام ریپازیتوری سایت نباید یکسان باشد. برای یوزرپیج احتمالا باید سورس را در یک برنج غیر از مستر ذخیره کنید و خروجی بیلد وبسایت را پوش کنید در برنج مستر. امتحان نکرده‌ام.
|
|
56
|
+
|
|
57
|
+
3. کامنت‌های استاتیک کار نمی‌کند!
|
|
58
|
+
|
|
59
|
+
روی گیت‌هاب اصلا نمی‌شود. من روی نتلیفای این کار را انجام داده‌ام و در [مقاله‌ای](https://mehdix.ir/static-comments.html) روش کار را شرح داده‌ام.
|
|
60
|
+
|
|
61
|
+
4. چگونه شکل و شمایل صورتی سایت را عوض کنم؟
|
|
62
|
+
|
|
63
|
+
متغیرهای CSS داخل فایل [`main.scss`](https://github.com/mehdisadeghi/jekyll-theme-mehdix-rtl/blob/master/assets/css/main.scss) را عوض کن.
|
|
64
|
+
|
|
65
|
+
</div>
|
|
66
|
+
|
|
67
|
+
## English Guide
|
|
6
68
|
This is the jekyll theme used for my personal Persian [website](http://mehdix.ir). Persian aka Farsi is written right-to-left, however some people use Roman script to write Persian language in messaging applications and social networks.
|
|
7
69
|
|
|
8
70
|
During the last few years people have reached out to me asking how to setup a persian Jekyll website with Jalali calendar support. Since Jekyll now supports themes, I created this theme based on my website to help others to bootstrap their own websites.
|
|
@@ -20,7 +82,7 @@ Take the following steps to make your own website based on this theme. First of
|
|
|
20
82
|
Then add this line to your Jekyll site's Gemfile:
|
|
21
83
|
|
|
22
84
|
```ruby
|
|
23
|
-
gem "jekyll-theme-mehdix-rtl"
|
|
85
|
+
gem "jekyll-theme-mehdix-rtl", "~> 3.0"
|
|
24
86
|
```
|
|
25
87
|
|
|
26
88
|
And add this line to your Jekyll site's `_config.yml`:
|
|
@@ -31,7 +93,7 @@ theme: jekyll-theme-mehdix-rtl
|
|
|
31
93
|
|
|
32
94
|
And then execute:
|
|
33
95
|
|
|
34
|
-
$ bundle
|
|
96
|
+
$ bundle install
|
|
35
97
|
|
|
36
98
|
Or install it yourself as:
|
|
37
99
|
|
|
@@ -39,18 +101,6 @@ Or install it yourself as:
|
|
|
39
101
|
|
|
40
102
|
You can override theme style by creating matching files with the same structure inside your Jekyll source tree. See Jekyll [Themes docs](https://jekyllrb.com/docs/themes/) for more information on that.
|
|
41
103
|
|
|
42
|
-
### Enable the Plugins
|
|
43
|
-
This theme uses some jekyll plugins. Enable them by adding them to the `plugins` section in the config file:
|
|
44
|
-
|
|
45
|
-
```yaml
|
|
46
|
-
plugins:
|
|
47
|
-
- jekyll-jalali
|
|
48
|
-
- jekyll-sitemap
|
|
49
|
-
- jekyll-paginate
|
|
50
|
-
- jekyll-hinduarabic
|
|
51
|
-
- jekyll-seo-tag
|
|
52
|
-
```
|
|
53
|
-
|
|
54
104
|
## Further customization
|
|
55
105
|
|
|
56
106
|
### Styles
|
|
@@ -91,18 +141,17 @@ For the time being I am using Netlify to handle custom comment forms on each pos
|
|
|
91
141
|
comments using the [`netlify_comments.py`](./netlify_comments.py) script.
|
|
92
142
|
|
|
93
143
|
### Forcing RTL code blocks
|
|
94
|
-
If you put code blocks and they appear incorrectly, you can use
|
|
144
|
+
If you put code blocks and they appear incorrectly, you can use _Markright_ gem. First add it to your Gemfile:
|
|
95
145
|
|
|
96
146
|
```ruby
|
|
97
147
|
gem "jekyll-markright"
|
|
98
148
|
```
|
|
99
149
|
|
|
100
|
-
And change your
|
|
150
|
+
And change your _config.yml_ respectively:
|
|
101
151
|
|
|
102
152
|
```yaml
|
|
103
153
|
markdown: Markright
|
|
104
154
|
```
|
|
105
|
-
|
|
106
155
|
### Footer
|
|
107
156
|
If any of the following ids is present in the config a corresponding item will be added to the footer:
|
|
108
157
|
|
|
@@ -132,4 +181,4 @@ information.
|
|
|
132
181
|
|
|
133
182
|
</div>
|
|
134
183
|
|
|
135
|
-
<div dir="rtl" lang="fa">مطلب مورد نظر</div>
|
|
184
|
+
<div dir="rtl" lang="fa">مطلب مورد نظر</div>
|
data/_includes/comment.html
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
{% assign config=site.comments.static %}
|
|
2
2
|
|
|
3
3
|
<article id="{{ include.comment.id }}">
|
|
4
|
+
|
|
4
5
|
{% if config.avatar.visible %}
|
|
5
6
|
<div class="comment-image-wrapper">
|
|
6
7
|
<img class="comment-avatar" src="https://www.gravatar.com/avatar/{{include.comment.email}}?s=200&d=robohash" />
|
|
7
8
|
</div>
|
|
8
9
|
{% endif %}
|
|
10
|
+
|
|
9
11
|
<div class="comment-body-wrapper">
|
|
10
12
|
<span class="comment-meta">
|
|
11
13
|
<small>
|
|
@@ -21,11 +23,13 @@
|
|
|
21
23
|
{{ include.comment.message | replace: "<p>", '' | replace: "</p>", newLine | replace: "<br>", newLine | strip_html | markdownify }}
|
|
22
24
|
<small class="comment-meta"> <a href="#comment-form" onclick="replyTo('{{ include.comment.id }}')">پاسخ</a></small>
|
|
23
25
|
</div>
|
|
26
|
+
|
|
24
27
|
</article>
|
|
28
|
+
|
|
25
29
|
<div class="reply">
|
|
26
30
|
{% for cc in include.comments %}
|
|
27
31
|
{% if cc.reply_to == include.comment.id %}
|
|
28
|
-
{% include comment.html comment=cc %}
|
|
32
|
+
{% include comment.html comment=cc comments=include.comments%}
|
|
29
33
|
{% endif %}
|
|
30
34
|
{% endfor %}
|
|
31
35
|
</div>
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
data/feed.xml
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
---
|
|
3
3
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
4
|
-
<?xml-stylesheet type="text/xml" href="{{'feed.xsl' |
|
|
4
|
+
<?xml-stylesheet type="text/xml" href="{{'feed.xsl' | relative_url}}" ?>
|
|
5
5
|
|
|
6
6
|
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="fa" >
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<link rel="alternate" type="text/html" href="{{ '/' | absolute_url }}" hreflang="fa" />
|
|
9
|
+
<link rel="self" type="application/atom+xml" href="{{ 'feed.xml' | absolute_url }}" />
|
|
10
10
|
|
|
11
11
|
<id>{% if site.atom_feed_id %}{{ site.atom_feed_id }}{% else %}{{ '/' | absolute_url | xml_escape }}{% endif %}</id>
|
|
12
12
|
<title type="text" xml:lang="fa">{{ site.title | xml_escape}}</title>
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: jekyll-theme-mehdix-rtl
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 4.0.
|
|
4
|
+
version: 4.0.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Mehdi Sadeghi
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2020-
|
|
11
|
+
date: 2020-04-08 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: jekyll
|
|
@@ -204,6 +204,9 @@ files:
|
|
|
204
204
|
- assets/js/disqus.js
|
|
205
205
|
- assets/js/main.js
|
|
206
206
|
- assets/js/showdown.min.js
|
|
207
|
+
- assets/pimg/ghpages1.png
|
|
208
|
+
- assets/pimg/ghpages2.png
|
|
209
|
+
- assets/pimg/ghpages3.png
|
|
207
210
|
- assets/pimg/saaghiabout.jpg
|
|
208
211
|
- assets/pimg/saaghiquery.jpg
|
|
209
212
|
- assets/uploads/dirtybike.jpg
|