#+TITLE: how to insert an image
#+SHORT-TITLE: images-1
#+KEYWORDS: website builder, beginner, images
#+TOC-KEYWORDS: manuals
#+DESCRIPTION: how to insert an image on a web page

* Related topics
- [[links][using links]]
- [[images-2][specifying image size and placement]]
- [[gallery][image gallery]]

* Local images
** Upload the image
1. Go to "Auxiliary files", write the name of the file containing an image (does not need to coincide with the file name on your computer).
   Only low-register letters are allowed in the file name.
2. Either click "create new file" or press *Enter*.
3. Your new zero-size file will appear in the table of auxiliary files.
4. Upload the file by pressing  icon.

** Edit the web page text source
5. Open the text source of the web page by clicking  icon.
6. Assuming the file name is cat1.jpeg, place the string\\
   \[\[image:*cat1.jpeg*\]\]\\
   in the text of your web page source, where you want your image to be inserted.
7. Save the text source

** Preview and publish
8. Preview the result by pressing  icon.
9. If it looks o.k., click  to publish the updated version of the web page.

* Simple embedding
** Example
A simple way to include an image on a web page:\\
\[\[image:cat1.jpeg\]\]

** Result
A simple way to include an image on a web page:\\
[[image:cat1.jpeg]]