Page tree
Skip to end of metadata
Go to start of metadata

Attachments

An attachment is any file that is included with your page. Examples of attachments are screenshots, photographs, other images, Word documents, presentations, PDF documents, videos and sound files. Attachments are useful when you want to share information that exists in another file format. You can attach files to any page or blog post, provided you have permission to do so.

To attach a file to the page:

  • Go to Attachments in the lower left corner.
  • Upload the attachment of your choice.
  • Or drag and drop the file from your computer straight onto the page you want to place the attachment.

Showing a list of attachments on your page

  • Place your cursor where you would like the list of attachments to appear then go to Insert > Other Macros, or start typing
{attachments}

 

  • Select the Attachments macro, which creates a list of attachments belonging to this page. For example, the following are the attachments on this page:

  File Modified
PDF File LANCE brochure.pdf LANCE brochure Jul 09, 2013 by Minnie Wong
Microsoft Powerpoint 97 Slideshow Timeline.ppt Timeline ppt Jul 09, 2013 by Minnie Wong

Macro parameters

Parameters are options that you can set to control the content or format of the macro output.

Parameter

Default

Description

Filename Patterns

all

A comma-separated list of regular expressions, used to filter the attachments by file name. Note that the parameter values must be regular expressions. For example:

  • To match a file suffix of 'jpg', use .*jpg (not *.jpg).
  • To match file names ending in 'jpg' or 'png', use .*jpg,.*png

Here is a tutorial on regular expressions.

Attachment Labels(none)A list of labels, used to filter the attachments to display. If you wish to enter more than one label, separate the labels with commas. Confluence will show only attachments that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Attachments and Embedding Content - PDF, Powerpoint, YouTube Videos, Google Maps.

Include Old Attachment Versions

false

A value of true will include previous attachment versions in the list.

Sort By

date

The sort order for attachments. Note that people viewing the page can change the sort order by clicking the column headings. Valid values are:

  • date – sorts by reverse chronological order (newest first)
  • size – sorts largest to smallest
  • name – sorts alphabetically
Sort OrderascendingUsed in combination with the Sort By parameter, to sort the attachments in ascending or descending order.

Allow Upload

true

If selected, the list of attachments will include options allowing users to browse for, and attach, new files.

Page Title(none)Used to display attachments from another page. If you do not enter a page title, the macro will display the files attached to the current page.

 

  • Save the page and you will now have a list of attachments for that particular page.

Embedding content

To embed content on the page, you have to first attach the document to the page (as above) or find the link to the document elsewhere in the Earthdata Wiki or online. This allows users to view the embedded content straight from the browser instead of having to download the file.

Error rendering macro 'excerpt-include'

No link could be created for 'Add a table of contents to a page'.

You may insert and embed:

  • Microsoft Powerpoint presentations
  • Microsoft Word Documents
  • Microsoft Excel spreadsheets
  • RSS feeds
  • Using the Widget Connector, you can embed YouTube videos, Flickr slideshows, Twitter streams, Google Docs and other content from the web.

Example: Attach and embed a Powerpoint Presentation

  1. Attach the Powerpoint presentation to the page: Click on Attachments in the lower left corner, browse and upload a file, then click Insert. It will also Create Link text as follows: Timeline.ppt
  2. To embed the Powerpoint presentation: Go to Insert on the editor menu > Other Macros, or start typing

    {powerpoint}

    to select the Office Powerpoint macro.

  3. Enter any of the desired parameters in the dialog box, you may refresh the view to see what effects the parameter changes have had on the Powerpoint. Click on Insert.
  4. When viewing the Powerpoint for the first time, the box will state that the Powerpoint is being converted and please wait and refresh after a while to view the Powerpoint.

 

Example: Attach and embed a PDF

  1. Attach PDF to the page. Click on Attachments in the lower left corner, browse and upload a file, then click Insert. It will also Create Link text as follows: LANCE brochure.pdf
  2. Go to Insert on the editor menu > Other Macros, or start typing

    {pdf}

    to select the PDF macro.

  3. Enter any of the desired parameters in the dialog box, you may refresh the view to see what effects the parameter changes have had on the PDF. Click on Insert.
  4. When viewing the PDF for the first time, the box will state that the PDF is being converted and please wait and refresh after a while to view the PDF.

Example: Embed a video from YouTube

  1. Go to Insert on the editor menu > Other Macros, or start typing

    {widget connector}

    to select the Widget Connector macro.

  2. Enter any of the desired parameters in the dialog box, you may refresh the view to see what effects the parameter changes have had on the window. Click on Insert.

 

Example: Embed a Google Map

  1. Go to Insert on the editor menu > Other Macros, or start typing

    {Google Maps}

    and select the Google Maps macro.

  2. Select any of the desired parameters in the dialog box. Click on Insert.

  3. Type in the name, for example "NASA Goddard Space Flight Center" or the coordinates of the area you want to focus on in the Google Maps code block. See the documentation to explore other ways to customize the map. (Note: Do not enter a comma between the city and state names

 

  • No labels