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
Gnome Screenshot (Ubuntu)
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)
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)
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)
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.
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.
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:
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
