file server help [...revising...] file server help [...revising...]

The following information is provided in hopes that it is helpful when viewing documents from this file server, even with an HTML explorer, a.k.a. "web browser".

There is no dependence upon scripting nor programming, neither from within the documents nor from the webserver.

Therefore, there is no reliance upon database software and their formats, neither on the webserver nor with the HTML explorer on the computer of the person requesting the documents. Notably, personal information is neither gathered nor required.

A document is intended as independent of its HTML, though with a little bit of fluff. The default properties of the HTML marks are acceptable, therefore a document remains independent of CSS.

Thereby, a document stands on its own without its stylesheet, visual differences are intended as informative, and traditional navigation within a document is enhanced (Note stylesheet).

Personal customization for viewing these HTML documents is possible by means of a personal stylesheet, especially by matching the domain name within the id attribute of the <html> mark (Customizing a personal stylesheet).

Basic details about using common buttonboard navigation of a document are also provided (Traditional navigation).

# layout of a marked document

Many of these HTML documents have a set of links to related documents at the bottom (Note stylesheet: related documents).

A file from this file server that is marked with HTML is intended as perusable without its stylesheet (Note stylesheet). That enables the complete absence of its stylesheet without penalty, such as when a document is saved offline.

That also eases reading the documents without an HTML explorer, and eases copy/paste of the minimally marked text from these documents into personal notes that are helpfully marked with HTML, too.

Most every HTML document has a title affixed to the top (Note stylesheet: constant document title), but that can be readily changed with a personal stylesheet. The very bottom has a link back to the introductory document at the file server.

# visual differences

There are a couple of notable visual differences declared for documents from this file server when compared with traditional characteristics of HTML marks. Anybody personalizing a CSS stylesheet for viewing a copy of these files should know the line under a hyperlink is actually a border, and the spacing along the left and right edges of these documents are actually borders.

Additionally, different shaped lines under a link indicate whether the link leads to another document or within the same document.

# underlining of hyperlinks

Traditionally, hyperlinks are underlined because visual distinction by means of a symbol is more reliable than contrasting more than two colors. The underlining has been thin, has been overlapping the descenders of letters in a word, and has been uncustomizable for over two decades.

The underlining for hyperlinks in these documents has been removed and a bottom border has been added (Note stylesheet: a hyperlink). This allows for a thicker line that is usually beyond the descenders of the letters of words, too.

# borders rather than margins

The space around the document content is minimized rather than fluffy. That provides efficiently shaped views without horizontal scrollbars or overflow, regardless of the size of a computer display, gadget, or sheet of paper (Note stylesheet: a document view).

Narrow borders are used for spacing on the left and right edges of a document, because margins and padding are uncolorable.

# customizing a personal stylesheet

Ultimately, the person viewing an HTML document makes the final decision for its alternate view with a personal stylesheet.

Before the turn of the century, personalizing was enabled with Simplicity, Flexibility, and Accessibility by the means of a personal Cascading Style Sheet (CSS) document ( 2.4 CSS design principles).

Ever since then, the everyday person has been customizing an HTML explorer for comfortably reading any HTML document requested (misnomered as "visited") from computers connected throughout the world, t.i. the World Wide Web.

That is because a person might have different comforts, abilities, or desires throughout the day, and an author of a document can never anticipate all possibilities for a single stranger, yet alone for everyone. Truly, it is the responsibility of the person viewing the document to make adjustments for personal comfort, as that person is in the best position to know the personal discomforts of that moment in that environment.

Curiously, using a personal stylesheet is considered by computer companies as "challenging". For example, one microcomputer software company has labeled it as an "accessibility" option within its HTML explorer, while another non-personal computer company has labeled it as "advanced". Other computer programmers require the person reads the computer source code of their HTML explorers in order to discover how to activate a personal stylesheet, if possible at all.

Nonetheless, the content of these documents are intended to be independent from their stylesheets. In that way, the <link> mark declaring the stylesheet can be removed and the document should still be comfortably readable. Or change the path in the <link> mark to a custom stylesheet, or add more stylesheets. Note that is different than using a personal stylesheet in regard to overruling rules, as they become stylesheets of the document itself.

The note stylesheet is documented with intent and use (Note stylesheet: introduction). There is also a means for specifying CSS rules for documents from only this file server so they can coexist with the CSS rules intended for documents from other file servers, all within the same personal stylesheet (There can be only one).

# documented HTML styles

The visual characteristics that have been changed and the intent for changing them have been consolidated into a single stylesheet for this file server for its most recent documents (Note stylesheet).

Sometimes a document has changes that are specific to only the document itself. The guidance and CSS rules will be either in the <style> region at the top of the document, or at the very bottom within an <iframe> region as an internal document.

There are very few classes for selectors of CSS rules within the stylesheets for these files. The id attribute is always intended for use as a fragment link, though sometimes the location is also enhanced. Overall, that should simplify specificity for selectors of CSS rules.

# there can be only one

Even though a personal stylesheet usually affects the visual characteristics of documents from all file servers, it is possible to affect documents from only one file server without creating multiple personal stylesheets. Alternatively, the HTML documents from this file server can be just as easily excluded with the :not() CSS selector.

The id attribute for the <html> mark in documents from this file server is declared for convenient use within personal stylesheets (Note guideline: aid personalized reading). It has the domain name for this file server "/", the path to the document, and then the document name without the superfluous ".html" suffix.

<html lang="en"

Note that it is within the document, therefore CSS rules matching it will work regardless of wherever the document is saved or renamed.

# introduction to CSS stylesheets

A personal stylesheet gives a person the opportunity to establish a more comfortable personal experience. A capable HTML explorer will apply a personal stylesheet to each HTML document viewed within it.

CSS is used for changing the default characteristics of marked regions in an HTML document, f.e. background color of text marked as a paragraph <p>. A basic stylesheet might be named "personal-styles.css", and might be as simple as a single rule and no other text.

{background-color: white !important}

Simply use a text editing program to create a plain text file. Typically, a plain text file is saved with a filename having the ".txt" suffix. For a personal stylesheet, it might help to add ".css" to the filename rather than ".txt" for the sake of some HTML explorers.

Any text embraced between /* and */ within a CSS stylesheet is personal commentary, a convenience for recording motivation and intent. Commentary will be ignored by the HTML explorer because it only uses the CSS rules.

# overruling rules

There are only three sources of CSS ( 6.4 The cascade): the stylesheet of the HTML explorer, the document (misnomered as "author"), and a personal stylesheet (misnomered as "user").

An HTML explorer provides from its own stylesheet its default values of properties for each HTML mark. For example, a common HTML explorer default is a white background color with a black text color for the body region.

{background-color: white
;color: black
;margin: 1.5in}

For a specific mark, a property for it in a personal stylesheet overrules the same property for it in a HTML viewer stylesheet. For example, a similar rule for the same <body> mark declared in a personal stylesheet, but with properties of different colors.

{background-color: black
;color: beige}

For a specific mark, a property for it in any CSS rule of the document overrules the same property for it in either a personal stylesheet or HTML viewer stylesheet. For example, a similar rule might be in a style region [ marked as <style> ] of the document or in a separate stylesheet [ a file referenced by a <link> mark ] .

{background-color: white
;color: gray}

The only way for a personal stylesheet to overrule a property value from CSS rules of a document is to add "!important" [ space around the exclamation mark ! is optional ] to the value. For example, declare each value of the color properties for the <body> mark to be important.

{background-color: black !important
;color: beige !important}

As such, what really matters is whether the value of a property for a specific mark declared in a personal stylesheet is more important than what the document declares for it.

While the document can also use "!important", its use in a personal stylesheet will overrule its use in the CSS rules of the document. To reiterate, the person viewing the document makes the final decision by means of the personal stylesheet.

# printing

While printing has been considered generally for HTML documents (Note stylesheet: the print medium), further adjustments with CSS might be desirable. The basic approach is black on white, and scaled images.

In general, there has been very little development of printing options by means of CSS within HTML explorers, even though computer programmers figured out how with other types of programs before the turn of the century.

Despite that, HTML explorers often offer additional print options by other means. Keep in mind, different HTML explorers offer different print options.

# traditional navigation

With the recent disappearance of scrollbars in document views of many computer programs, it is worthwhile knowing about commonly available means for scrolling a document by the press of a button on the buttonboard.

# tabbing from link to link

Decades ago, the TAB button on a buttonboard would emphasize the next hyperlink in a document, holding SHIFT while typing TAB would emphasize the prior hyperlink, and the RETURN or ENTER buttons would reveal the document addressed by the hyperlink. Some HTML explorers would thoughtfully enable the TAB button to focus on the first link in the current view of the document rather than at the beginning of the document.

That was helpful for when using a pointer on the screen was too much effort or coordination, such as when eating in front of the computer. While it is also considered as an "accessibility" aid, it has become common in many other programs besides HTML explorers. Thereby, variations for what the TAB button will focus upon might be in the buttonboard settings rather than accessibility settings. As such, everyone can traverse a document link by link and visit the next desired document without sliding and lifting clunky devices, nor smudging the viewer screen.

The item emphasized, or focused, is also considered as the targeted location within the document view. For example, fragment links for sections are provided with the octothorp "#" symbol at the heading of a section (Note stylesheet: a flagged heading). Activating its link will move that heading to the top of the view, whether by buttonboard or pointer. Similarly, pressing the button on the pointer device arbitrarily within the document might set the targeted location at the pointer. Either way, that becomes the targeted location of the document, and from where the TAB button focuses the next or prior link.

As the means are coexisting, it might sometimes be convenient to select a fragment link (f.e. the "#" links) with the pointer and then use the TAB button to move on from that location in the document link by link, followed by the RETURN or ENTER buttons whenever a link is worth its jump.

As aforementioned about hyperlinks in documents from this file server, text with a dotted underline has a note [ such as this one ] immediately viewable when it has the focus, rather than having to reference a listing of notes. Such text is focusable either by using the TAB button or by moving the pointer over it. Pressing the button on the pointer retains the focus so the pointer can be moved out of the way.

# scroll with the buttonboard

Another way of scrolling a document is by typing the space button for revealing the next viewful of the document (like the Page Down button), and by holding SHIFT while typing the space button for revealing the prior viewful (like the Page Up button). This, too, has remained as an option in HTML explorers and many other programs.

More in:
Note stylesheet