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.
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.
Images are one kind of particulars which can use text styling in their captions. It is possible to have a list of attributes (using bold style) and their values listed one above another by putting them on separate lines and having two columns between an attribute and its value. These can be used to e.g. define or characterize different types of particulars. Also works with images in a pictureshow. Caption texts, if not using mentioned attribute and value pairs, can have text string "_originated_" replaced with image particular's "Source" value and which will then be shown in small caps using font whose letter spacing is slightly looser than usual. Similar styling can be defined to be used on other parts of the caption text by inserting two "_" charactes to where from styling should beging and where it should end at.
Some other specific types that can be attached are videos (YouTube, Vimeo, streamable video files, maybe others), tweets, SoundCloud music, streamable audio files, coding examples (CodePen and JSFiddle at least), podcasts (about thirty different hosting services), etc.
When using a direct link to video or audio, player's style is currently based on what browser offer by default. It is advisable to place the files to be streamed to be available through the CDN service that is already in use (files can be transfered using SFTP.
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.
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.
An image type particular type can be used in writings, image collages and adequates. Below images are internal links to where images have been used (adequates, writings and pictureshows) and near by are also images' in-editable description and read-only source information. Both of them can be edited by actually selecting the image. There's also a switch to hide them if they seem to discracting at the moment. Hovering mouse pointer an image reveals tool buttons such as Details, Crop, Remove, Reduce images, Load Image and "Large Preview". Opening a large preview image also gives access to the OCR function, which is an external service that tries its best to recognize text in images and provide the letters, words and sentences that it founds as plain text. The Reduce images function means that all image sizes larger than 640 pixels that were prescaled during the image upload phase are removed. Crop is also available at the upload phase, but after the upload it is also possible to create multiple new particular images from a selected area of the selected image, which is useful if, e.g. when several areas of an image might work better as separate images. To make it easier to browse through images of selected container, the "Large preview" image can be changed using the arrow buttons.
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.
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 image cropping tool can be accessed by holding down the Ctrl key when drag'n'dropping images to the upload dropzone (the bordered area which has label "Upload") or when changing a single image. That will open a modal window which has two different Upload buttons, one of which instructs server to use medium size (640 pixels wide) as the maximum image size for the selected images. Images are uploaded to the server using 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).
The 1600 pixels is the maximum width at which an image can be viewed in a public work, but in reality the transferred image has also been scaled to a slightly larger size when possible, just in case there was not enough interest to crop the images at the time of transfer. Later cropping of an image can be enabled by Ctrl-clicking on any image in the image list, which opens a modal window with only image re-cropping and saving functions. This functionality is available in the 'Browse specific types' view, as well as in the 'Experimental' view, which is a kind of combination of the 'Browse specific types' and 'Edit text' views. In the "Particular browsing" view it also possible to create new images based on the area marked with cropping tool, as well as an option to scale the cropped image up by one size.
In the writing fine-tuning view, there is a wide range of quick adjustments to try out and choose from. These include the font of the text in the body of a writing, positioning of ingress and style of the border optionally surrounding images. To apply adjustments to several writings at once, it is sufficient to first make the appropriate adjustments to one writing and copy them to the other writings selected in the mass editing view.
Some of these adjustments are probably less frequently needed, but useful to have available when you need them. One such is the adjustment that makes line breaks for reference and/or meta text (not shown in the picture) be done at any point. Without using it e.g. long web addresses might extend past the boundaries.
Quick adjustments affecting the whole work also have their uses, for example to make the content of the front page of the work more preparatory (more on this elsewhere) and to make small adjustments from language selection to caching and from setting the publicity to setting page width. For some works, it may be useful to set the scalability of the images presented in small size so that they do not end up being too small (will get set to 80% width on a smartphone, for example) and it may sometimes be user-friendly for the reader to enable icons to indicate, for example, the inclusion of videos and image collages in some writings. Caching per work is very useful in avoiding server load (even a few seconds of caching is very useful).
From time to time more solution spesific settings become available. Some others include the "Page menu", which allows each page of a work to display a menu that is largely automatically generated from collections of writings available in the public work, from presentatation pages or from blog layouts. Any special pages are also put to these menus or, if no menus are used, at the beginning and end of the rest of e.g. table of contents. If special pages should be omitted from page menu its name need to start with character ":".
Shareablekey refers to a parameter that can be placed at the end of the public address of a work or any of its pages and whose value, if given correctly, allows a work being in private-mode work to be read without having to make the work public. "Allowed tags" means tags separated by commas, which determine which of tags added to an writing (a separate text field) are taken into account in contexts where tags can be used to do something.
One can choose to display the cover image of a work on all pages or on the front page using the solution-specific setting, but it is also also possible to select whether the image should be displayed in a larger size or not at all, and how title of a work should be displayed or whether to not show it at all by "tweaking" special page "Opening section"'s name. The same tweaks also affect the appearance of the PDF version of the solution, if one decides there's need for such.
In practice, if the name of a "Opening section" special page starts with:
Those could have been implemented with buttons, but maybe there are enough of them already?
For other specialpages it is possible to have:
(when using pagemenu)
(when not using page memu and the content listing type is "plain structure")
(when not using page menu and the content listing type is other than "plain structure".)
Some settings like "Dates in writings' metainfo" may not do anything as such, and one also need to adjust the metainfo setting in the "writing fine-tuning" view so that the meta info of writings actually appears anywhere. Without these settings, date of a writing would not appear at all, but with them it can be placed near the titles or at the end of writings.
Every solution can be put to maintenance mode, which is manifested to users as a message that replaces everything else while maintenance mode is in effect. Maintance mode causes this message to be shown, when a reader tries to access a published work: "Solution has been put in to maintenance mode, which is a different choice from making it private. Someone probably just wants use time and care to perfect the solution without revealing anything too soon. If one had to guess, changes take an hour to finalize, but who knows."
In the project managing view, there are project-specific backup functions that allow you to backup everything or something to be kept somewhere else or to be exported to another project a moment later.
A whole project with its writings, images and other stuff can be wrapped in a zip package with a single button press and if needed, the same zip package can be dragged to the project list in the project list view, where a new project is generated from the contents of that zip package. Please note that this will also regenerate all the image catalogs used by the project, i.e. no attempt will be made to combine the new project with any existing image catalogs in the service.
To be honest, the ability to put multiple projects in a single backup without the backup containing the image catalogs used by those projects multiple times is already available, but the user has to enable such functionality separately due to the potentially high server load. Backups generated in this way can be drag'n'dropped into the project list view as usual (image catalogs would not be duplicated even if multiple projects use the same ones).
If one presses the Shift key during drag'n'drop and targets certain project, no new project will be created, but the solutions of the backupped project will be merged with the target project (including the image catalogs). This is useful, e.g. when one wants to create one big project from solutions that are spread over several other projects.
If you don't need to backup the whole project, but just want to copy collections of writings from a project so that they can be used in another project, you can copy these writings as JSON structured data, which can be passed as input in the importing view of another project. The item moving view would not allow the moving of writings beyond the boundaries of a single project.
Each work has its own project page, which contains navigation links/buttons to all the views and modal windows relevant to the project, from the beginning of writing to fine-tuning the final work, from backup to selecting image catalogs and from asset management to search functions. Here are some of these separate views.
Importing. This screen contains the "drag and drop" area for uploading image files to the server. Images can be imported one by one or multiple ones at a time (serially uploaded). In addition, this view allows you to import JSON-structured data containing collections of writings for the project in question (exported originally in the project managing view). Entire projects with all their images etc. would be imported in the project listing view. In the user-specific settings, there is a setting that causes all the acceptable image formats to be saved in non-destructive PNG format. The "Particulars (images to be added to articles, etc.)" page provides more information on, e.g., how to affect the pre-scaling size of images and how to bring up the image cropping tool.
Moving writings and images. Even if images have already been placed in the writings, it does not prevent moving of images from one image container to another or the whole image container to a different image catalog, since images are referred to by an id code which does not change when the images are moved. The view includes switch buttons to change the possible destinations of images and captions, so that in one position the transfer is only possible within the limits of a project and the image catalogs associated with a project, but since sometimes one wants to move writing or images elsewhere, too, that has been made possible. In addition to moving writings, they can also be copied.
Writings can be copied from one project to another by using the export function in the project management view as it generates JSON data that can be given as input data in the import ciew of another project. Other means of copying project elements are the "overwrite writing" and copy/paste functions that are available in the text editing view. The "image assorting" view (described in the writing "Freeform image assorting") could also prove to be beneficial.
Mass actions for writings. You may want to do some operations on several writings at a time, such as hiding parts of a writing that are not needed (e.g. ingress), replacing odd-looking quotes with more common ones, or styling multiple writings to look similar. Doing these things one by one would be quite a clunky job. Other benefits include the ability to see the dates of all the writings in a work at once, and if needed, change them. From the image you might guess that changes can only be made to a collection of writings at a time, but it should be mentioned here that holding down the Ctrl key while selecting a collection of writings from the menu does not replace the previous listing, but adds them to the list. The header fields in the table can used for sorting in a predictable way.
Searching for writings. After you have written enough and/or have not written for a long time, the search functionality can be useful to find your writings. The occurrence of a search term is highlighted in both the headings and the body text of search results. Around the occurrence of the search term, some text from related writing is shown before and after it. In this view, you can initialise a search by adding the parameter "seachquery" to the url and giving it a search criterion. If the search criterion begins with "author:", it is assumed that the text following it refers to an authorid (these are created in the Authors section of the user preferences).
The front page of a work is a kind of introduction or content listing about what the work contains, and when you change the type of content list, it is this front page that changes most in the work. There are other alternatives to the book-like table of contents, including the "presentation page", which can contain sets of writings arranged in different ways, and a "blog-like", which presumably means a blog-like presentation, where the layout can be adjusted in some way.
In the case of presentation page writings, a "mainimage" for a writing can be displayed (referred to as a "feature image" in some other services/applications). The mainimage must (optionally) be set for each writing separately in the view where the appearance of the writings is fine-tuned and where, for example, images can be included to the writings. A mainimage is also (optionally) used on a writing page as a header image or then just on a introduction pages alone.
On the works' front page, the "presentation page" could look like this. It shows several different writing sets made from the same collection of writings, in some cases with the writings automatically placed and in others the writings are placed manually. Published work can use multiple layouts, if enabling setting "Page menu" is selected in solution's adjustments.
There are about seven writing sets that require manual placement and about seven writing sets for which it is sufficient to just select a writing collection. There are about twenty styling and adjusting options to choose from (image from earlier version).
At the top of the view is a menu from which to select presentation pages created for the project. At the bottom, they are listed in such a way that you can change their order, change their names, change their participating setting and get an address that you can refer to, e.g. in writings.
Presentable pages containing one of more writing sets can be saved for later use. Writing sets can be ordered by simple dragging them using the mouse or other pointing device. Redirect links work in writing sets, too. When a new presentation page is created, a random name is generated for it. The presentation page can be duplicated as well as the blog appearances.
The writings in a blog-like work may be spread across several collections of writings, as the date of the writings determines the order in which they appear to the reader. A work may also contain collections of writings that are not even visible to the reader, but are in the project just for some reason.
For visibility on the presentation page, writings have two changeable dates, one of which is the date that determines the order of writings (publication date) and the other is displayed in the title of a writing (optional update date).
This is what a blog-like work might look like with standard styling.
(Actually.. you'd better take a look at: example: Blogging about something)
There are almost twenty buttons for adjusting the appearance (image from earlier version), which affect margins, image sizes, text ribbon layouts, etc. You can save as many element layouts as you feel you might need.
This is what a blog-like work might look like with a few quick tweaks. The visibility and placement of the writing-specific tags is one of the controls.
If there are a lot of writings in a work, just listing their names would take up a lot of screen space, making it less easy for the reader to grasp the scope of the work, or perhaps all the writings are in some way equally valuable/important, so why list all the names separately if all of one or more of the writings are intended to be read?
This, in all its simplicity, allows the reader to get straight to the point: the writings of all the collections of writings in the work are displayed below, separated by the name of the collection of writings, as they would appear if read separately.
[no image, might be needed to mention]
It is often more comfortable to write when there is more text from the same writing visible, as this reduces memory load. A single text field stretched wide and long is not always convenient enough, so a couple of different text writing modes was prototyped for experimentation. The "sliced" one of those has been developed to feel neat to use.
In this alternative text editing text is automatically split into several parts at the points where there subtitle is either bold, type of "Header 1" or type of "Header 2". This can be useful e.g. at the phase when one is just preparing to write something and want to keep a large amount of already written text quickly and visually presented. Also useful when there are lots of subtitles like e.g. in a writing that acts as a link directory.
If images or other attachments have been attached to the writing, they remain unchanged on save, even if they are not displayed to indicate that they are attached to it. Just a reminder: attaching differs from including. The placeholders stay where they were if they aren't removed while editing text.
If the text content is in a plaintext or a Word file, it can dropped to a "slice" at the point where the cursor is at that moment. The order of these "slices" can be changed manually by first selecting the "moving slices" mode and then moving them as desired. The "slices" can be reversed by using one of the dedicated buttons, which is useful, for example, if user have written things in chronological order but want them in the reversed order.
Another alternative way of editing text is to use the "lots of text editing" view. It allows to glanze writing collection's writings with less effort. There is a toggle button to make the catalog images in the writings appear as thumbnails at the end of the writings. Other particulars are not shown, but they are kept in writings even when saving and the quicklook functionality is usable (hovering the pointer over a placeholder). The switch also limits the maximum height of writings, so that there is not so much to scroll through, because of many longish writings. This is one of the views that has a "Stickyness" switch, which allows certain part of the view to remain roughly in its place when the page is scrolled vertically.
Although you can attach image particulars to an open writing by drag'n'dropping them from the "browse particulars" view, the kind of "compactness" offered by the view combining the "browse particulars" and "text editing" views may be preferable, since glancing between two different views requires a subtle mental reorientation. When same time is spent in the same view
When all the time is spent in the same view, no such "extra fumbling" is needed. Editing writing works exactly the same as in the actual "text editing" view, with the difference that images can be added only by drag'n'dropping from the list on the left. As in the "browse particulars" view, images can be viewed in large size (by clicking on the image) and recropped in the modal window that opens (by Ctrl-clicking on the image).
And if there are so many images that you can't even see the writingparticulars list when you look at the bottom ones, it is also possible attach images from the catalogue by clicking on the image while holding down the Alt key.
In this alternative particular browsing view image-type particulars are first presented in the usual way, laid out on a grid, after which one can start moving them around in the view without any special movement constraints. A large tablet device or a other touchscreen device with a stylus pen becomes a practical combination, as the range of hand movement can be much less than with a mouse.
Viewing images in their largest size isn't offered as feature in this view, but images can laid out on two different sizes, which hopefully are enough for letting them be differiented from each other.
On a touchscreen device there can could be a feature allowing to grab an image with two fingers and rotate the image while perhaps also resizing it. However, such may be a bit too "gimmickry" without much benefit.
This view also allows movimg images from one image container to another by holding down the Alt key while clicking on an image and (before that) pre-selecting the image container that should be used as a target container to move images to. For the sake of clarity, image containers that are potential targets can be removed from their list by clicking on them while holding down the Alt key. When using mobile devices, a separate physical keyboard can be used, or one choose to show a switch button corresponding to the Alt key (setting available in user-spesific settings, applies to certain views).
When using keyboard clicking of an image while pressing Shift key will enlarge the clicked image. Pressing the Shift and Ctrl keys together will make an image from larger to smaller.
The infinite type of viewport of this free-form image browsing is one where images can be spread out beyond the visible area and where you can move the viewport by grabbing the background of the view. It allows you to open images from multiple image containers. It could be used to develop a viewport where you can freely browse images and also edit text, but for now it is an experimental feature that can be enabled in the user preferences. One problem with it is that if you use gestures-type plug-in in the browser, they may lose their ability to draw a visual line in the right place, since their functionality often relies on them editing the displayed web page by adding code to it. In addition, some browsers on many devices do not quite allow the viewport to be infinite.
Included particulars of a writing that is been edited are by default presented in the form of a textual symbol, where memorability is aided by a preview version that can be shown by hovering the mouse pointer over it. An alternative would be to implement a text editor where everything is always presented as it appears publicly, but embeddable particulars that get loaded from elsewhere often do not load immediately. It would be a bit of a slow down and would meaninglessly direct attention to how something is still taking shape while thoughts should be focused on the ideas related to the writing.
That's why so-called "better placeholders" mode is selectable from the editor's Misc menu. Available in views "text editing" and "writing fine-tuning". Location of any placeholder element can be changed as usual in both editor modes, i.e. first the cursor to some position in a writing (preferably between text paragraphs) and then Ctrl-clicking on some placeholder.
Largely separate from the production of works, there is a view for collecting, sorting and editing adequates, where a few different types of items can be used to aid thinking and remembering. Different types of item include links, textual notes, images, videos, graphs generated from data and "scientific notes" (PubMed and other scientific abstracts). These items can be organised into adequetesets and the adequetes within them. Adequate content for images and videos can be displayed in larger or smaller size.
If you want to keep the adequates and adequates in a certain order, you can still list the adequates as you like, e.g. in a private article or in browser bookmarks by linking to the adequates directly. There is a toggle in the Adequates view to display these links.
An adequateset already set for a project can deselected, as it only affects whether those adequatesets are selectable in this view. Several projects can use the same adequatesets. Unlike with image catalogs, adequatesets are not included in the project-specific backup, but are backupped separately as separate zip packages that can be imported back if necessary.
The image items are same as image particulars, which can attached/inclued to writings as both use images from image catalogs. Links can be added by e.g. drag'n'dropping them directly from browser bookmarks, one by one or folder by folder, as well as from the address field of browsers and link-type files. Relevant modal window is accessible by clicking the "Add item" button. It also allows one to add e.g. YouTube videos, but item types are more limited than what could be attached/included to writings. To add sciency-type items, a separately provided application is required.
The use of links has a few peculiarities, one of which is that its data is retrieved by an external service, which is currently limited to retrieving the page title. Once the link has been added, it can be manually sent (with a button) to another external service, which takes a screenshot of the full page behind the link, returns this image in its internal response, and then saves it to a user-specific "Quick saves" image container, from where it can be moved to another one or be kept there. Cross-device synchronisation between browsers can be used to collect links by keeping a publishing application open in one of them and collecting links first, e.g. to browser's bookmarks.
Images can be added individually or to an existing image Item, which makes it a multi-image Item. The latter is initiated by first adding a single image using the Attach to the adequate button and then continuing with the Add to the item button. These can be found in the "add image particular" modal window. Multi-image items are displayed as stacked, when showing contents of an adequate containing it and separately in the Item preview panel. Each image is accompanied by a link to the "particular browsing" view and the image container there.
As in the "particular browsing" view, an OCR operation can be performed on the images, the results of which will be added to the text content of that item.
Backupped adequatesets can be imported to a project by drag'n'dropping them onto the "Project's adequatesets" menu element. Item of an adequate can be moved from one adequate to another by simply dragging item of an opened adequate and dropping it on the name of target adequate.
It has been considered if it should be possible to a) browse the material on a separate monitor using a hand gesture recognition device, b) browse and edit the material in virtual reality using a separate tactile control device, c) send an item viewed on a desktop view for viewing on a mobile device, but these are so far only interesting prototypes, which were intended to streamline a possible new approach to introducing such functionality.
Table of contents of a work. If you had simply created a project, made a collection of writings and saved a few writings to it, without any fine-tuning of the writings, you would already almost have a table of contents for the work. All that would still be needed is to select which collections of writings to include in the work from the fine-tune writings view. In the work-specific adjustments view, you could put a cover image for the work, which would be shown by default above the table of contents.
Writing page of a work. If some fine-tuning had already been done e.g. on the typeface and the stylization of the borders of the included images, the effects of the adjustments would be immediately visible on the writing page of a work. All the final works have direct links to the collections and writings, both in the table of contents and elsewhere. The images in the writings can be viewed in larger size.
At the side of a writing or between paragraphs of text, you can place an area to provide additional information, a summary etc., which is called a "sidebar" in the publishing "scene", but in this service it has already become known as a sidebar. It is possible that this may be confused with a slightly later feature, which has been provisionally named "sideshow" and which is basically a sidebar at the side of the front page of a work, where basically anything can be placed (statistics, advertisements etc.). Here are a few available sidebar border style adjustments to make it stand out from the rest of the text.
You can use images as content in these writings, but not pictureshows, nor anything embeddable. Due to memory load, it might be advisable to initially keep them in the same writing collection as the writings they are part of. In the fine-tuning writings view, hovering a pointer over a writing that uses one of these will cause the included writing to indicate its inclusion visually if they are in the same writing collection. All kinds of writings can be freely moved within the project boundaries from one writing collection to another without worrying about breaking integrity.