- Do not
commit
quickly, wait for the current commit to bebuilt
, then do the second commit, otherwise the build procedure may be cancelled. - Know hierarchy of files:
_config.yml
------------> configure sidebar panel and reference links
Hamid Manouchehri
tab ------------>README.md
Projects
tab ------------>projects.html
------------>_posts/
- Considering loading commits takes time, wait for some minutes to see output of your modification in your Blog. Frequent commits may lead you to make the mistake of that some changes does not work, or you have something wrong with the code, whereas, there is nothing wrong, but previous change have not been deployed yet.
- Right caption:
Fig. 1
Wrong caption:Fig.1
- Crop images with minimum border to have become more suitable in terms of vertical margins in webpages.
- Do not add comment to
projects.html
andarchive.html
, otherwise it makes problem to load including sources. - Do not change
_posts/
files intohtml
, it is easier to work with markdown syntax and even it supportshtml
. - Sometimes page
refresh
does not function, to see the changes of commits, so it is a good idea to close the tab and open it again:
setting
>pages
> link of the blog - To generate equations for the web pages, go to CODECOGE, write your equation and remember to select
HTML
output. To label you equation, at the end of equation put;
then writeequ(number_of_equation)
. - When you rush to do something, just find the easiest way nor the efficient or perfect one. As an example, it is a bit hard to insert multiple images in a row with separate captions via
HTML
, because you'll need to createresponsive
web pages to avoid inappropirate loading of the contents of your webpages in different browsers, of course it is cumbersome to do them all without web development frameworks. Just take it easy and firstly edit images inLibreOffice Word
, align them in a row and insert caption, then take export it as an image file or more easier, take an screenshot, then upload it as a single image inHTML
. - The
Preview
tab does not work properly for some modifications occasionally, so it's better to check the results in the webpages. - Important Note: When there something wrong with the code, rendering, style or anything else, remember that there is nothing wrong with the servic, parser, or etc. It is, in 99.9% of occurrences, a human mistake, just check your code again, double check, triple check, and if you can not find it, get help from others, ask someone to take a look at your code. It is sometimes hard to see the most obvious faults as point of your view.
- To enter Greek letters within a sentence, you have two options:
- Insert in Markdown syntax:
$$\greek_letter_name$$
, it is true for other mathematic expressions, e.g.$$A^T_{\alpha}$$
:$$A^T_{\alpha}$$ - Insert in HTML syntax:
&greek_letter_name;
- Insert in Markdown syntax:
- In HTML (for Markdown too) letters between `` (back quotes) do not render.
- To create your
HTML
document, an easy way is to read other HTML web pages, like Wikipedia. Just go to a specific page on Wikipedia, then pressCTRL + u
and navigate the HTML source to be more familiar with the syntax.