Clarify image usage #2494
Clarify image usage #2494
Conversation
The documentation in the auto-generated conf.py is a little vague with how images can be used. The patch clarifies that ambiguity. refer discussion here: https://groups.google.com/d/topic/nikola-discuss/WDhmd6bEPm8/discussion
|
This should also be somewhere in the handbook. |
|
@Kwpolska do you mean here - https://github.com/getnikola/nikola-site/blob/master/stories/manual.txt ? If so, I'll send a pull request to that repository too. |
|
docs/manual.txt in this repository (make a second commit to your |
| @@ -5,6 +5,7 @@ Bugfixes | |||
| -------- | |||
|
|
|||
| * Don’t crash if a post list has no posts (Issue #2489) | |||
| * Clarify conf.py documentation on using images | |||
There was a problem hiding this comment.
(We don’t really need that level of detail in changelogs.)
removing CHANGES.txt entry making a new section in manual.txt for embedding images
|
Not sure how to include information about thumbnail directive in conf.py without being too verbose. Have made the other changes - also updated the manual entry with an ReST example. Included the thumbnail directive there. Does it look good now? |
| Assuming that you have your pictures stored in a folder called images (as configured above), | ||
| you can embed the same in your posts with the following ReST directive, | ||
|
|
||
| .. code:: python |
There was a problem hiding this comment.
.. code:: rest
.. image:: /images/example.png
That will be enough. Without height, width, alt, align.
|
Removed the attributes. |
Signed-off-by: Chris Warrick <kwpolska@gmail.com>
|
Merged (and expanded on a bit in a6a3471), thanks. This will go live on our website whenever we release v7.8.0. |
The documentation in the auto-generated conf.py is a little vague
with how images can be used. The patch clarifies that ambiguity.
refer discussion here:
https://groups.google.com/d/topic/nikola-discuss/WDhmd6bEPm8/discussion