Files

Wed, 18 Dec 2019 18:08 UTC by AppSoftware

Note that files cannot be linked to directly from anywhere other than the AppSoftware Journals web application due to restrictions replaced on the referrer. Journal Files is not intended to be a file sharing platform, however you can copy links from other services into your markdown where this restriction won't apply.

You can upload any type of file as a Journal File provided that it is within size limits.

Images

Screenshots / Screen Clippings / Web Images

To make uploading screenshots from your desktop or images from the web quicker, you can copy images to your clipboard and paste directly into the entry editor to upload.

The Snipping Tool and Snip & Sketch in Windows 10 have copy buttons that will copy the current image to the clip board. Ubuntu's screenshot tool has simi

Windows 10 Snipping Tool

ClippingTool.png

Gnome Screenshot (Ubuntu)

Ubuntu.jpg

Image Attributes

Where uploaded files are images, they can be modified to change their display size by adding parameters to the URL.

Max width

You can set the max width so that your image will be resized proportionally so that it's width does not exceed the specified maximum width.

Add max-width=<value> to the query string for the image URL:

The unit for max-width is pixels.

Example (markdown)

![example.jpg](https://journals.appsoftware.com/api/asset-source/s3/app-software-journal-journal-files-prod/journal-files/19/15/areguc/caac8f8e-9b55-4b3d-a7bf-ac6f7e0fd808_example.jpg?max-width=200)

example.jpg

Max height

You can set the max height in the same way.

Add max-height=<value> to the query string for the image URL:

The unit for max-height is pixels.

Example (markdown)

![example.jpg](https://journals.appsoftware.com/api/asset-source/s3/app-software-journal-journal-files-prod/journal-files/19/15/areguc/caac8f8e-9b55-4b3d-a7bf-ac6f7e0fd808_example.jpg?max-height=200)

example.jpg

Quality

You can reduce the quality of the image for faster page loads by using the quality parameter:

Add quality=<value> to the query string for the image URL:

The value for quality should be between 1 and 90.

Example (markdown)

![example.jpg](https://journals.appsoftware.com/api/asset-source/s3/app-software-journal-journal-files-prod/journal-files/19/15/areguc/caac8f8e-9b55-4b3d-a7bf-ac6f7e0fd808_example.jpg?max-width=200&quality=30)

example.jpg

Alternate Image and File Hosting / Sharing

The files feature does have some limitations around the maximum file sizes that you can upload, and the maximum about of data that can be stored based on your plan.

If an alternative is required, you can use other services to host images:

ShareX (Windows)

ShareX is a great service which facilitates both image and file sharing and helps to manage the uploading and obtaining of URLs from several image and cloud file services (such as Dropbox, below). Where your cloud file service supports generating public links that can be used to link to content from your entries, ShareX will generate the correct URL for you.

https://getsharex.com

ScreenCloud (Windows / Linux / Mac)

ScreenCloud provides the same essential functionality as ShareX but is also cross platform so it can run on Linux / Mac as well as Windows.

https://screencloud.net

Imgur

Imgur is a service for sharing images publicly. If you need to share images with more privacy controls, or need to share other file types, you may want to consider Dropbox or a a similar service (possibly in conjunction with ShareX).

https://help.imgur.com/hc/en-us/articles/209592766-Tools-for-Imgur

Dropbox (Direct)

Dropbox allows you to share files directly from their service. URLs can be modified according to the desired behaviour.

If you share and copy the link from your dropbox client you will get a URL as below. If you paste this link into your browser, you will see the file hosted on the dropbox web app.

https://www.dropbox.com/s/wtf7rfqyzv3oje5/example_file.png?dl=0

If you want to link to an image directly, you can add replace the www subdomain with dl to get a direct link.

https://dl.dropboxusercontent.com/s/wtf7rfqyzv3oje5/example_file.png?dl=0

You could then display this as an image using markdown like so:

![example](https://dl.dropboxusercontent.com/s/wtf7rfqyzv3oje5/example_file.png?dl=0)

Or in an HTML image like so:

<img src="https://dl.dropboxusercontent.com/s/wtf7rfqyzv3oje5/example_file.png?dl=0" alt="example" />

Finally, if you want to force a file to be downloaded rather than displayed in the users browser, you can replace the dl=0 with dl=1 in the URL query.

https://dl.dropboxusercontent.com/s/wtf7rfqyzv3oje5/example_file.png?dl=1

UI block loader
One moment please ...