.. include:: /shortcuts.rstext
.. index::
pair: Block category; Files and images and video
Files, images and video
---------------------------
These artefacts are internal Mahara ones to display:
* links to files that you have uploaded
* folders that contain files
* show images
* embed audio and video files
If you are on a mobile device and select to upload a file, you can take a photo or make a video or audio recording (Android only for audio) directly.
.. index::
pair: Blocks; Embedded media
single: Files and images and video block; Embedded media
.. _embedded_media_block:
Embedded media
~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-video-camera fa-border fa-2x`
Display an embedded video or audio file from your uploaded files. Mahara comes with the `Video.js `_ media player that allows for the display of a number of file formats without having another player installed on the device.
.. note::
The site administrator :ref:`must allow media formats `. Some of them can be displayed directly within Mahara while others need additional software installed on a device. See the :ref:`list of allowed media formats `.
Videos placed onto a page in this block scale to the width of their column. They also scale automatically when your browser space gets smaller.
.. figure:: /images/page_editor/blocks/embeddedmedia_configure.*
:alt: Configure the block Embedded media
Configure the *Embedded media* block
#. **Block title**: Choose a title for your block.
#. **Files area**: Choose from which files area you would like to select a media file:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. License information: You see these fields if the site administrator turned on :ref:`license metadata `. Additionally, if you are in an institution, your institution administrator :ref:`may require you to provide a license `.
* **License**: Your default license is displayed. You can set your default license in your :ref:`account settings `. You may choose a different license for each individual artefact.
* **Licensor**: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
* **Original URL**: If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file.
#. **File**: You do not have to go back to your *Files* area in *Create* in order to upload a file. You can do so directly from this screen.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Edit* button |edit| to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
.. note::
You can still select files that have been submitted in another portfolio page.
#. Click into the row that contains the file you wish to display in the block to select it or click the *Select* button |select|.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. note::
Only the files that you are allowed to embed are displayed. If you uploaded a mp4 file but it does not show here, you may have to check if it has the correct codec. Only H.264 mp4 files can be embedded.
iOS devices can even be trickier as these devices may only recognize the MPEG4 "Baseline" profile rather than the "High" profile. You can read the `Apple specifications `_ and convert a video if needed using `Handbrake `_. Newer iOS devices (from the iPhone 5S on) should play "High" profile videos.
.. index::
pair: Blocks; File to download
single: Files and images and video block; File(s) to download
.. _file_download_block:
File(s) to download
~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-download fa-border fa-2x`
Select files that viewers of your portfolio can download.
.. figure:: /images/page_editor/blocks/filedownload_configure.*
:alt: Configure the block Files to download
Configure the *File(s) to download* block
#. **Block title**: Choose a title for your files block.
#. **Files area**: Choose from which files area you would like to select a file:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. License information: You see these fields if the site administrator turned on :ref:`license metadata `. Additionally, if you are in an institution, your institution administrator :ref:`may require you to provide a license `.
* **License**: Your default license is displayed. You can set your default license in your :ref:`account settings `. You may choose a different license for each individual artefact.
* **Licensor**: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
* **Original URL**: If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file.
#. If the site administrator turned on the :ref:`image resizing option `, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.
#. **File**: You do not have to go back to your *Files* area in *Create* in order to upload a file. You can do so directly from this screen.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Edit* button |edit| to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
.. note::
You can still select files that have been submitted in another portfolio page.
#. Click into the row that contains the file you wish to display in the block to select it or click the *Select* button |select|.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. note::
You cannot re-order files once you have selected them. You would need to remove them and select them again in the correct order.
When the block is placed on the portfolio page, you can view more information or download the files.
* file name
* file description
* size
* upload date
* a link to more details
.. figure:: /images/page_editor/blocks/filedownload_details_1.*
:alt: File download details
Details about files that can be downloaded.
#. View information about the file:
* file name
* file description
* size
* upload date
#. Click the file name to be taken to the details page for this file.
#. Hover over a file and click anywhere into the row or on the download icon to download the file.
.. _file_details_page:
When you click the file name, you are taken to the details page for that particular file and see some more metadata.
.. figure:: /images/page_editor/blocks/filedownload_details_2.*
:alt: Metadata for a file that can be downloaded
More details about a file that can be downloaded.
#. The name of the file is displayed.
#. The title of the page in which the artefact appears is linked.
#. The author of the page is displayed and a link to the profile page provided.
#. Additional metadata is displayed for the file:
* file type
* description
* tags
* owner
* creation date
* last modified date
* size
* license (:ref:`if license information is turned on by the site administrator `)
#. Click the *Download* button to download the file to your computer.
#. If the owner of the file allowed comments, you can :ref:`comment ` directly on the file.
#. Click the *More options* button |three dots button| to reach lesser used functionality:
* Add the page that contains the file to your :ref:`watchlist ` or remove it.
* Report the file as containing :ref:`objectionable content `.
.. index::
pair: Blocks; Folder
single: Files and images and video block; Folder
.. _folder_block:
Folder
~~~~~~~~
:fonticon:`fa fa-folder fa-border fa-2x`
Select a folder to display all files within it as links on your page.
.. figure:: /images/page_editor/blocks/folder_configure.*
:alt: Configure the "Folder" block
Configure the *Folder* block
#. **Block title**: If you do not set a title, the name of the folder that you choose to display will be used.
#. **Files area**: Choose from which files area you would like to select a folder:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Expand* icon |plus| if you want to reach a sub folder.
#. You can edit any component of the folder, i.e. its name, description and tags by clicking the *Edit* button |edit|.
#. Click into the row that contains the folder you wish to display in the block to select it or click the *Select* button |select|.
.. note::
You can also still select folders that have been submitted in another portfolio page.
#. Click *Remove* |remove| if you wish to revert your choice.
#. **Sort order of files**: :index:`Decide on the sort order ` of files in the block when they are displayed on the page. You can choose between:
* Ascending
* Descending
.. seealso::
Site administrators decide on the default sort order of content within folder in the :ref:`Blocktype: File / folder settings `.
#. **Show download link**: :index:`Switch this option ` to "Yes" if you wish to allow the viewers of your page to download the folder contents as zip file.
.. seealso::
Site administrators decide in the :ref:`Blocktype: File / folder settings ` whether users are allowed to display the download link or not.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. warning::
When you place a folder with group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
You can see information about the folder as well as the files contained within it when the block is placed on a page.
.. figure:: /images/page_editor/blocks/folder_details_3.*
:alt: "Folder" block on a page
"Folder" block on a page
#. Block title.
#. Click the file name to be taken to the details page for this file.
#. Hover over the file and click anywhere into the row or on the *Download* icon to download the file.
#. Click the *Download folder content as zip file* to download all files in one go to your computer.
#. Click the *Details* link |details| to be taken to the details page for the block.
On the details page for the *Folder* block you see the following.
.. figure:: /images/page_editor/blocks/folder_details_1.*
:alt: Details page of a "Folder" block
Details page of a "Folder" block
#. Block title.
#. The title of the page in which the block appears is linked.
#. The author of the page is displayed and a link to the profile page provided.
#. Click the file name to be taken to the details page for this file.
#. Hover over the file and click anywhere into the row or on the *Download* icon to download the file.
#. Click the *Download folder content as zip file* to download all files in one go to your computer.
#. Click the button with the three dots |three dots button| to reach lesser used functionality:
* Add the page that contains the file to your :ref:`watchlist ` or remove it.
* Report the file as containing :ref:`objectionable content `.
When you clicked on a file, you are taken to that :ref:`file's details page `. You always see which folder contains the file.
.. figure:: /images/page_editor/blocks/folder_details_2.*
:alt: Details page of a file within a "Folder" block
Details page of a file within a "Folder" block
.. index::
pair: Blocks; Image
single: Files and images and video block; Image
.. _image_block:
Image
~~~~~~~~~
:fonticon:`fa fa-picture-o fa-border fa-2x`
Display a single image in a block.
.. note::
In a default Mahara instance, this block is available in the content chooser at the top together with the simple *Text* block. It does not appear in the section *Media* as well.
.. figure:: /images/page_editor/blocks/image_configure.*
:alt: Configure the image block
Configure the *Image* block
#. **Block title**: Choose a title for your block.
#. **Files area**: Choose from which files area you would like to select an image:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. License information: You see these fields if the site administrator turned on :ref:`license metadata `. Additionally, if you are in an institution, your institution administrator :ref:`may require you to provide a license `.
* **License**: Your default license is displayed. You can set your default license in your :ref:`account settings `. You may choose a different license for each individual artefact.
* **Licensor**: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
* **Original URL**: If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file.
#. If the site administrator turned on the :ref:`image resizing option `, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.
#. **File**: You do not have to go back to your *Files* area in *Create* in order to upload a file. You can do so directly from this screen.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click into the row that contains the file you wish to display in the block to select it or click the *Select* button |select|. You only see image files that you are allowed to use in the block.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
#. Click the *Edit* button |edit| to change any component of a folder or file, i.e. its name, description, rotation, and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
.. note::
You can still select files that have been submitted in another portfolio page.
If you rotate an image via this dialogue, it will be rotated in all other places where it is used as well.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Show description**: Set the switch to "Yes" if you wish to display the description of your photo. It could contain the source of it for example.
#. **Width**: Choose the width (in pixels) for your image. If you do not provide a number, the image will be scaled to the width of the block.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. index::
pair: Blocks; Image gallery
single: Files and images and video block; Image gallery
.. _image_gallery_block:
Image gallery
~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-picture-o fa-border fa-2x`
Select a folder with images or individual images to show in a gallery or embed an external image gallery.
Image gallery with uploaded images
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. figure:: /images/page_editor/blocks/imagegallery_configure.*
:alt: Configure the block "Image gallery"
Configure the *Image gallery* block with internal images
#. **Block title**: Choose a title for your image gallery block.
#. **Image selection**: You can choose to display all images from a specific folder or you can select the images individually. See :ref:`embedding images from an external gallery ` for that option.
.. note::
If you choose to display an image gallery based on a folder and you rename images within that folder, they will be reordered accordingly.
#. **Files area**: Choose from which files area you would like to select an image:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Expand* icon |plus| if you want to reach a sub folder.
#. Click the *Edit* button |edit| to change any component of the folder, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit the file.
#. Click into the row that contains the folder or image you wish to display in the block to select it or click the *Select* button |select|. You only see image files that are allowed to be used in the block. You can also still select folders or files that have been submitted in another portfolio page.
.. note::
If you selected to display an entire folder in your image gallery, new images that you upload to that folder are added to your gallery automatically.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Style**: Decide to show all selected images as thumbnails or as slideshow where you only see one image at a time. If you select the option "Thumbnails (square)", all your images will be displayed in the same size as thumbnails.
.. note::
If you select to display your images in a slideshow, you can navigate all images with the help of the icons *Next* |gallery_next| and *Previous* |gallery_previous|. Use the icons *First* |gallery_first| and *Last* |gallery_last| to start or end your slideshow.
#. **Show descriptions**: :index:`Turn this option on ` if you want to display the image descriptions in the gallery.
#. **Use photo frame**: Using this option will put a frame around each photo.
#. **Width**: Specify the width (in pixels) for your images. The images are scaled to this width.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
.. index::
single: Image gallery from external images
.. _external_image_gallery:
Image gallery from external images
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. figure:: /images/page_editor/blocks/imagegalleryexternal_configure.*
:alt: Configure the block Image gallery
Configure the *Image gallery* block with external images
#. **Block title**: Choose a title for your image gallery block.
#. **Image selection**: Select the option "Display images from external gallery".
#. **Gallery URL or RSS**: Copy the link to the external gallery and past it into the text box. You can embed the following external galleries:
* Flickr, e.g. https://www.flickr.com/photos/12345678@N01/sets/98765432123456789/
* Photobucket, e.g. http://s1234.photobucket.com/albums/ee123/username/ or http://s1234.photobucket.com/albums/ee123/username/AlbumName/
* Picasa, e.g. http://picasaweb.google.com/user.name/AlbumName#
* Windows Live Photo Gallery, e.g. http://cid-123456ab7890cd12.photos.live.com/self.aspx/AlbumName/photo.jpg
.. note::
* To use Flickr, the site administrator has to :ref:`provide a valid API key `.
* To use Photobucket, the site administrator has to :ref:`provide a valid API key and a secret API key `.
* For Windows Live Photo Gallery to work properly, the link to one of the photos inside the album must be copied and pasted into the text box in order to show the entire album.
#. **Style**: Decide to show all selected images as thumbnails or as slideshow where you only see one image at a time. If you select the option "Thumbnails (square)", all your images will be displayed in the same size as thumbnails.
#. **Show descriptions**: :index:`Turn this option on ` if you want to display the image descriptions in the gallery.
#. **Use photo frame**: Using this option will put a frame around each photo.
#. **Width**: Specify the width (in pixels) for your images. The images are scaled to this width.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. index::
pair: Blocks; PDF
single: Files and images and video block; PDF
single: Embed PDF
.. _pdf_block:
PDF
~~~~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-file-pdf-o fa-border fa-2x`
Embed PDFs into a page.
.. figure:: /images/page_editor/blocks/pdf_configure.*
:alt: Configure the PDF block
Configure the *PDF* block
#. **Block title**: Choose a title for your PDF block.
#. **Files area**: Choose from which files area you would like to select a file:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. License information: You see these fields if the site administrator turned on :ref:`license metadata `. Additionally, if you are in an institution, your institution administrator :ref:`may require you to provide a license `.
* **License**: Your default license is displayed. You can set your default license in your :ref:`account settings `. You may choose a different license for each individual artefact.
* **Licensor**: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
* **Original URL**: If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file.
#. **File**: You do not have to go back to your *Files* area in *Create* in order to upload a file. You can do so directly from this screen.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Expand* icon |plus| if you want to reach a sub folder.
#. Click the *Edit* button |edit| to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
.. note::
You can still select files that have been submitted in another portfolio page.
#. Click into the row that contains the file you wish to display in the block to select it. You only see PDF files.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
Once the PDF is embedded on a page, you can scroll through it and also download it for example. The PDF is displayed in its best possible fit to show one page completely.
.. figure:: /images/page_editor/blocks/pdf_view.*
:alt: Embedded PDF on a page
Embedded PDF on a page
#. Title of the block.
#. Toggle to the sidebar where you can jump from one page to another either in the thumbnail or document outline view.
#. Click the *Search* icon to search within the document.
#. You can move to the previous or next page using the *Arrow* icons.
#. The number of the current page is displayed. You can put a different number in and hit the *Enter* or *Tab* key and jump to that directly.
#. The total number of pages is shown.
#. Decrease the page size by clicking the *Minus*, or increase the page size by clicking the *Plus*. The block size does not increase.
#. Use the *Automatic zoom* drop-down menu to choose a different zoom size instead of using the *Plus* and *Minus* buttons.
#. Click the *Print* icon |pdf print| to print the PDF.
#. Click the *Download* icon |pdf download| to download the PDF to your computer. The suggested file name is the one the file has on the site.
#. Click the *Tools* icon |pdf tools| to see more options available for this PDF.
#. Use the scrollbar to move through the document.
#. Click the *Details* link |details| to be taken to the details page for the block.
.. seealso::
If you have trouble embedding a PDF file, you might have come across an issue that `others have also experienced `_. The mimetype of the PDF may not be recognized correctly. The correct "mimetype" is "pdf", but programmes can circumvent using this mimetype for PDFs to ensure that their file is downloaded instead of viewed in the browser for example. There is not an easy fix to this issue, and `the discussion of possible solutions has started `_.
In the meantime, you can delete the incorrect mimetypes from your browser and ensure that only "PDF" is left.
|firefox_preferences|
Follow these steps to delete the incorrect mimetypes:
#. Close Firefox.
#. `Locate your profile folder `_.
#. Open the **mimeTypes.rdf** file in a text editor.
#. Search for **pdf**.
#. Leave only the entry that is **application/pdf**.
#. Delete all other PDF references by deleting everything for that entry from `` to ``.
#. Open Firefox and go to *Preferences → Applications*.
#. Search for **pdf**. You should now only see one entry that reads "Portable Document Format (PDF)".
.. index::
pair: Blocks; Some HTML
single: Files and images and video block; Some HTML
.. _html_block:
Some HTML
~~~~~~~~~~
:fonticon:`fa fa-code fa-border fa-2x`
Display the content of an HTML file in a page.
.. figure:: /images/page_editor/blocks/html_configure.*
:alt: Configure the block Some HTML
Configure the *HTML* block
#. **Block title**: Choose a title for your block.
#. **Files area**: Choose from which files area you would like to select an HTML file:
* **My files**: You see all the folders and files that you have created.
* **Group files**: You see all the :ref:`folders and files that you are allowed to publish `.
* **Institution files**: If you are an institution administrator, you will see institution folders and files.
* **Site files**: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder *public* in the *Site files*.
#. License information: You see these fields if the site administrator turned on :ref:`license metadata `. Additionally, if you are in an institution, your institution administrator :ref:`may require you to provide a license `.
* **License**: Your default license is displayed. You can set your default license in your :ref:`account settings `. You may choose a different license for each individual artefact.
* **Licensor**: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
* **Original URL**: If you are uploading somebody else's file, provide a link to the original Internet address so that others can go there and view the original file.
#. **Upload file**: You do not have to go back to your *Files* area in *Create* in order to upload a file. You can do so directly from this screen.
#. **Folder path**: The breadcrumbs show in which folder you are currently.
#. Click the *Edit* button |edit| to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
.. note::
You can still select files that have been submitted in another portfolio page.
#. Click into the row that contains the file you wish to display in the block to select it or click the *Select* button |select|. You only see HTML files.
.. warning::
When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.
#. Click *Remove* |remove| if you want to revert your selection.
#. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are:
* **No**: The block and its content is displayed at all times.
* **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|.
* **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content.
#. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time.
#. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is.
.. note::
You can only display a self-contained HTML file in a page, but not an entire site because the links to the files are not retained correctly when you upload files.