Update docs

This commit is contained in:
Alexandre Vicenzi 2020-04-20 23:38:29 +02:00
parent 533bc1760e
commit 8e4a88edde
131 changed files with 17402 additions and 4778 deletions

View file

@ -9,7 +9,7 @@
<p>If you choose wisely, ads are a way to win some money, but if not, you may loose your users due to excessive use of ads.</p>
<p>Flex has six places for ads. Google recommends up to 3 ads per page. There is ads page only, and banner that appears on all pages.
Below you can see how to enable ads in your pelican configuration file.</p>
<div class="highlight"><pre><span></span><span class="n">GOOGLE_ADSENSE</span> <span class="o">=</span> <span class="p">{</span>
<div class="highlight"><pre><span></span><code><span class="n">GOOGLE_ADSENSE</span> <span class="o">=</span> <span class="p">{</span>
<span class="s1">'ca_id'</span><span class="p">:</span> <span class="s1">'ca-pub-1234567890'</span><span class="p">,</span> <span class="c1"># Your AdSense ID</span>
<span class="s1">'page_level_ads'</span><span class="p">:</span> <span class="bp">True</span><span class="p">,</span> <span class="c1"># Allow Page Level Ads (mobile)</span>
<span class="s1">'ads'</span><span class="p">:</span> <span class="p">{</span>
@ -21,7 +21,7 @@ Below you can see how to enable ads in your pelican configuration file.</p&gt
<span class="s1">'article_bottom'</span><span class="p">:</span> <span class="s1">'1234566'</span><span class="p">,</span> <span class="c1"># Banner after article content (article only)</span>
<span class="p">}</span>
<span class="p">}</span>
</pre></div>
</code></pre></div>
<p>Version 2.1.0 also comes with new translations. You can see available translations <a href="https://github.com/alexandrevicenzi/Flex/wiki/Translations">here</a>.</p>
@ -40,7 +40,7 @@ You can read about <a href="https://github.com/alexandrevicenzi/Flex/wiki/Tra
If you use English it changes nothing for you.
But if you want to use translation you need to add new lines to your pelican configuration file.</p>
<p>Here is a small example to use Flex in another language.</p>
<div class="highlight"><pre><span></span><span class="c1"># Enable i18n plugin, probably you already have some others here.</span>
<div class="highlight"><pre><span></span><code><span class="c1"># Enable i18n plugin, probably you already have some others here.</span>
<span class="n">PLUGINS</span> <span class="o">=</span> <span class="p">[</span><span class="s1">'i18n_subsites'</span><span class="p">]</span>
<span class="c1"># Enable Jinja2 i18n extension used to parse translations.</span>
<span class="n">JINJA_EXTENSIONS</span> <span class="o">=</span> <span class="p">[</span><span class="s1">'jinja2.ext.i18n'</span><span class="p">]</span>
@ -50,7 +50,7 @@ But if you want to use translation you need to add new lines to your pelican con
<span class="n">DEFAULT_LANG</span> <span class="o">=</span> <span class="s1">'de'</span>
<span class="n">OG_LOCALE</span> <span class="o">=</span> <span class="s1">'de_DE'</span>
<span class="n">LOCALE</span> <span class="o">=</span> <span class="s1">'de_DE'</span>
</pre></div>
</code></pre></div>
<p>Last but not least, Flex supports the feature "X minute read", similar <a href="https://medium.com/">Medium</a>.</p>
@ -81,11 +81,11 @@ But if you want to use translation you need to add new lines to your pelican con
<p>So, after some new blogs with this theme, I got issues and PRs on GitHub from these new users. This weekend I had some free time and I release the <a href="https://github.com/alexandrevicenzi/Flex/releases/tag/v1.1">second version</a> of Flex (aka v1.1).</p>
<p>This new version doesn't include nothing so special, just some bug fix and a new setting to allow custom CSS stylesheets.</p>
<p>The new custom setting can be used like this:</p>
<div class="highlight"><pre><span></span><span class="n">EXTRA_PATH_METADATA</span> <span class="o">=</span> <span class="p">{</span>
<div class="highlight"><pre><span></span><code><span class="n">EXTRA_PATH_METADATA</span> <span class="o">=</span> <span class="p">{</span>
<span class="s1">'extra/custom.css'</span><span class="p">:</span> <span class="p">{</span><span class="s1">'path'</span><span class="p">:</span> <span class="s1">'static/custom.css'</span><span class="p">},</span>
<span class="p">}</span>
<span class="n">CUSTOM_CSS</span> <span class="o">=</span> <span class="s1">'static/custom.css'</span>
</pre></div>
</code></pre></div>
&lt;p&gt;I would like to thank all who helped in this new version.&lt;/p&gt;</content><category term="News"></category><category term="pelican"></category><category term="python"></category><category term="theme"></category></entry><entry><title>Flex: Responsive Pelican theme</title><link href="http://flex.alxd.me/blog/flex-pelican-theme.html" rel="alternate"></link><published>2015-07-22T08:00:00-04:00</published><updated>2015-07-22T08:00:00-04:00</updated><author><name>Alexandre Vicenzi</name></author><id>tag:flex.alxd.me,2015-07-22:/blog/flex-pelican-theme.html</id><summary type="html">&lt;p&gt;I just start a new fresh blog using &lt;a href="http://getpelican.com"&gt;Pelican&lt;/a&gt;. Sometimes choosing a theme for a new site is something difficult that takes time.&lt;/p&gt;
@ -126,19 +126,19 @@ Mem: 5866 4674 1192 386 0 2404
Swap: 20480 1267 19213
&lt;/samp&gt;&lt;/p&gt;
&lt;p&gt;If you like to share code snippets, you can take advantage of &lt;a href="http://pygments.org/"&gt;Pygments&lt;/a&gt; syntax highlighting:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;&lt;span class="c1"&gt;// Foo&lt;/span&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;&lt;code&gt;&lt;span class="c1"&gt;// Foo&lt;/span&gt;
&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="nx"&gt;bar&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Foo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;object&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;&lt;code&gt;&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Foo&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;object&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="fm"&gt;__init__&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="bp"&gt;self&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bar&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="bp"&gt;self&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;bar&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;bar&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;ls *.jpg &lt;span class="p"&gt;|&lt;/span&gt; xargs -n1 -i cp &lt;span class="o"&gt;{}&lt;/span&gt; /external-hard-drive/directory
&lt;/pre&gt;&lt;/div&gt;
&lt;div class="highlight"&gt;&lt;pre&gt;&lt;span&gt;&lt;/span&gt;&lt;code&gt;ls *.jpg &lt;span class="p"&gt;|&lt;/span&gt; xargs -n1 -i cp &lt;span class="o"&gt;{}&lt;/span&gt; /external-hard-drive/directory
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; The code block looks like GitHubs colors.&lt;/p&gt;