**SPIP**
# Article proposé
L’article "**Add an image to an article using SPIP 3 **
(https://www.spip.net/ecrire/?exec=article&id_article=6491)" est proposé
à la publication depuis le mardi 22 janvier 2019.
* * *
## Add an image to an article using SPIP 3
mardi 22 janvier 2019 , par [naema](.././?page=auteur&id_auteur=8207&)
SPIP 3 provides two ways to enable you to add an image :
* As an illustration : used to illustrate the text of your article, i.e.
inside the very body of your article ;
* As attached documents or portfolio : used to insert heavier images, to
create a slideshow, a contact sheet... i.e. outside of the text of your
article, that will be displayed below the text. Please note, this option is
only available if the webmaster has activated the feature in :
Configuration > Site content > Attached documents > Activate the document
download for this content : Articles.
SPIP 3 integrates the image download method from the Medias plugin (that is
provided by default with SPIP 3, previously known as multimedia library).
You can now add/upload images (or documents) in one of the following ways :
* From my computer : to upload a document that is saved in the hard-drive
of your machine (or any other device connected to your computer, eg. a
thumbdrive, just select the appropriate directory) ;
* From the media library : to select a document that has already been
uploaded into the website, by browsing through the main Media page that
lists all "media" documents ;
* From the server : to upload documents previously transfered by FTP in
the /tmp/upload directory (the best way to rapidly upload large documents,
heavy files or large quantities of documents to your site) ;
* From the internet : to upload a remote document such as a YouTube
video, a Flickr image, a zip file from the GitHub community, etc.
## Add an image as an Illustration
Go to your article page. The document upload form is accessible both
through the View/Consultation and the Edit pages of your article.
**Document upload from the Edit page of the article **
On your left handside is a tool box to upload a document, as below :
Select or upload your document through one of the 4 methods described above
and click on "Upload". Your image will now be listed on the left handside,
with its thumbnail, its title (if there was one attributed to the image,
otherwise it says "No title") and below, a list of shortcut templates to
help you insert your image in the body of your article.
You can upload several documents, they will be listed in queue in the
upload order.
Please note that at this point, your image is not yet in the body of your
article : you need to explicitly write the shortcut of your choice (chosen
from the shortcut templates - simply copy and paste the code) in the text
of your article where you wish your image to appear.
You can update the document information (eg. the title, description, or
credit line...) by clicking on the listed document and add or modify the
appropriate field. Don’t forget to save your modifications. You might do
so either before or after including the image to your text, the update will
be taken into account in either cases.
**Document upload from the Consultation/View page of the article **
On the very bottom of the article stands the Document icon, as below :
Click on it and it will display the same tool box as illustrated above.
Select or upload your document in the exact same way.
Your image will be displayed at the bottom of the article in the
"Illustration" insert.
## Add an image in the Portfolio
**Reminder :** This option is permitted only if the webmaster has enabled
the Attached Document feature.
Add your image in the exact same way as described above.
In the image thumbnail box you’ll see another link : "Drag in the
Portfolio".
**Tip : ** If you upload your documents altogether in a zip file, SPIP will
further offer supplementary options such as chose the document order,
automatic entitling, etc.
## Identify if the document is set as an Illustration or in the Portfolio
**In the Edit page of your article **
When you edit your article, all media are listed on the left handside and
they are identified in a different way depending which modality was chosen
:
* a different icon : postcard icon (document as Illustration) or
paperclip (document in the Portfolio)
* different shortcut templates.
Icon
Image type
Suggested shortcut templates
Postcard
Illustration
`<img>`
Paperclip
Portfolio
`<doc>` and `<emb>`
---------------------------------------------------------------------------
Read also : SPIP images shortcuts : know-how
(https://www.spip.net/ecrire/?exec=article&id_article=6485)
**In the View/Consultation page of your article **
At the bottom of the page, both types of images are listed in their
appropriate section.
## How can I change the image setting, from an Illustration to the
Portfolio, or from the Portfolio to an Illustration ?
In the View page of the article, the Image setting insert offers the
appropriate option :
* Remove from the Portfolio (if the image is set in the Portfolio), or
* Drag in the Portfolio (if the image is set as an illustration).
— Envoyé par SPIP (https://www.spip.net/)
---------------------------------------------------------------------------
