After much browsing of online dictionaries, it has been decided to name the images, videos, tweets, image collages, etc. that can be attached to the writings as "particulars". Images are the only ones that can be stored in image catalogs for use in a number of different writings. In terms of workflows, placing particulars to an writing requires both attaching them to the article (text edit view) and including them (writing fine-tuning view). Not all of the particulars may even be used, but only those that are actually included. Particulars may be referred to by placing a ref marker.

Attaching and including particulars (like images) to writings

It is a deliberate choice to make particulars in the text that is been edited to appear in the form of placeholder elements that symbolize them and which in the case images have image id number and given image width. The position of these placeholder elements can be changed either by clicking on to select it and then moving it by arrow keys, with the Ctrl key held down (one paragraph of text at a time) or, perhaps more easily, by placing the cursor where you want it and then clicking on the placeholder element with the Ctrl key held down.

A quick preview version is available for any particular type by hovering the mouse pointer over the placeholder element. Alternatively, placeholder elements can be made to appear more visually (a function in the text editor's Misc menu), so that e.g. images look like images in the editable text (but without any fine-tuning).

Selectable images in an image catalog (its individual container) are displayed in the modal window of the text editing view, although they could of course be displayed in a different way.

It is possible to change the order of the images attached to the writing in the text editing view, but this is only for convenience at the time of writing, i.e. it does not affect the order of the images in the text. The captions of the images are displayed with the images attached to the writing.

When a highres version of an image is stored and available, a visual indicator is displayed in various contexts. In some contexts, this indicator is revealed by the user and in others it is constantly visible.

Other particulars (than images)

Some other specific types that can be attached include videos (YouTube, Vimeo, maybe others), tweets, SoundCloud music, coding examples (CodePen and JSFiddle at least), podcasts (about thirty different hosting services), etc.

Using maps in your writing is a spectacular way to clarify location. An external API is used for reverse geocoding purposes to convert e.g. a given location like a city name into map coordinates. There are a few different choices as a map service to use.

Third-party software components are used to display maps, and initial tryouts in implementing them have given rise to a wide range of ideas on how to allow the user to make use of the maps. Possibilities include the use of stylistically different map tiles, elements to be added on top of the map and route guidance. Another consideration is that the use of map services may be subject to a fee up to a certain level of use and that the number of access times per some time period may be limited. It may be that the user will have to acquire a user account for a map service to get access to its API. Registration for these services is probably easy, but it may take a while to navigate their web interface to find where the required API key can be obtained.

A bunch of images is classified as a third, completely different type of particular and which can include several images from one or more image catalogs, which can then be used to make a image slideshow or any other type of presentation available in the writing fine-tuning view. Each of these images can have its own caption in addition to the optional caption for the image collage. The order of the images can be varied when forming the image collage.

In the text edit view, the attached image collages are displayed next to the text as a set of images. Attached image collage can be used as a basis for a new image collage.

Browsing image catalogs

The particular browsing view is only for those particulars that are located as images in image catalogs. The selected project limits which image catalogs are selectable in this view. An image catalog already assigned to a project can be safely removed from the assigned ones, as it does not affect e.g. images already attached or included to a writing or writings, as their visibility and functionality is based on the ids they have.

Functions in this view include deleting images, creating and deleting containers, editing image attributes (description, source), viewing in largest size, downloading an image to a file, etc. A image type particular type can be used in writings, image collages and adequates. There are direct links to relevant ones of those below the images.

Understanding which image catalog and which image catalog container the image is in can be forgotten, and one might not want to bother searching for it by navigating through many navigational moves. It is easier to click on a link that takes you to a particular browsing view and where relevant image catalog and its container are already opened. As an example, here is a link below the image displayed in the writingparticular panel of the text editing view. The images in the special pages, adequates and writing fine-tune views also have similar links in use.

Cropping images before uploading and highres images

The importing, item moving and particular browsing views bring up a cropping tool, which allows you to (locally) edit images uploaded to the server by cropping out the unnecessary areas. The actual scaling of images to different sizes is done on the server. The cropping tool is accessed by holding down the Ctrl key when dropping images to the upload dropzone (the bordered area which has "Upload" above it) or when changing a single image. Otherwise, the images are simply uploaded to the server (with a progress indicator).

When uploaded new images or when updating an existing one, pressing the Shift key at the beginning of the upload gives a signal that you wish to get original images scaled to highres versions, also, i.e. 1600 pixels wide (if the original image is at least that wide).