Original-Widgets.css

/*************************************************************************************************/
/*************************************************************************************************/
/* CSS-Rules applied to HTML Widgets / Entities originally created by the 'javadoc' Tool itself  */
/*************************************************************************************************/
/*************************************************************************************************/


/*
 * The CSS Rules & Definitions that have been placed in this file are all rules that apply to HTML
 * Elements that were inserted onto a page by the original Sun / Oracle Java-Doc Tool.  The rules
 * inside this CSS-File are all applied to CSS Class & Id names that are very simple and begin with
 * a capitalized letter 'C' and followed by a number.
 *
 * These CSS CLASS & ID Attributes were inserted, by the Upgrader, into HTML Elements that were all
 * on the original Java-Doc Generated Web-Page before the Upgrade Process had begun.
 *
 * NOTE: The over-use of the "!important" thing, is needed to override any / all definitions from
 *       the original JavaDoc CSS File.  Some of the uses of !important in this file might be 
 *       superfluous, but CSS can cause a lot of head-aches when trying to account for colors,
 *       spacing, etc...
 * 
 * Don't read too much into the (possibly over-application) use of "!important".  These will one
 * day be more closely analyzed and removed where possible, but for now they are being overly
 * applied.
 * 
 * The original JavaDoc CSS-File is *ALSO* still included, and used, with all JavaDoc Ugraded
 * Web-Pages. The File "javadoc/stylehseet.css" is the original CSS-File that was created by the
 * Sun / Oracle javadoc Tool.  This is why there are so many "!important" tags, to override the
 * any definitions (which, to this day, I still don't really understand) in that file.
 *
 * CSS seems so easy on first / cursory inspection!  But then as soon as you try to nail it down to
 * leave out all mistakes, make it look perfect / finished - THERE ALWAYS BE SOMETHING WRONG WITH
 * IT.
 */


/* ********************************************************************************************* */
/* Special Google 'Cinzel Decorative' font                                                       */
/* ********************************************************************************************* */

/*
 * This is a really neat font for the little gray rounded rectangles, and the summary and 
 * detail headers.
 *
 * DOWNLOADED FROM:
 * https://fonts.gstatic.com/s/cinzeldecorative/v12/daaCSScvJGqLYhG8nNt8KPPswUAPni7TTMw.woff2
 */
@font-face
{
    font-family:    'Cinzel Decorative';
    font-style:     normal;
    font-weight:    400;
    src:            url('../fonts/CINZEL.woff2') format('woff2');
    unicode-range:  U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC,
                    U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF,
                    U+FFFD;
}

/*
 * BOLD CINZEL (700)
 * https://fonts.gstatic.com/s/cinzeldecorative/v12/daaHSScvJGqLYhG8nNt8KPPswUAPniZoadlESTE.woff2
 */
@font-face
{
    font-family:    'Cinzel Decorative';
    font-style:     normal;
    font-weight:    700;
    src:            url('../fonts/CINZEL_BOLD.woff2') format('woff2');
    unicode-range:  U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC,
                    U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF,
                    U+FFFD;
}

/*
 * BLACK CINZEL (900) - "Even Bolder than Bold"
 * https://fonts.gstatic.com/s/cinzeldecorative/v12/daaHSScvJGqLYhG8nNt8KPPswUAPniZQa9lESTE.woff2
 */
@font-face
{
    font-family:    'Cinzel Decorative';
    font-style:     normal;
    font-weight:    900;
    src:            url('../fonts/CINZEL_BLACK.woff2') format('woff2');
    unicode-range:  U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC,
                    U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF,
                    U+FFFD;
}


/* ********************************************************************************************* */
/* The very Top of every documentation page: Java Package, CIET Title, and Inheritance-UL        */
/* ********************************************************************************************* */

/* 
 * Java-Doc "Package-Label" is the line directly above the CIET-Title.  The fist line is the
 * "JAVA PACKAGE INFO".  This is an HTML <DIV> Element.
 *
 * NOTE: The CSS class 'packageLabelInType' is one generated by Java Doc itself.
 *       It cannot be used because it does not actually wrap *ALL* of the text.
 *
 * ALSO: The !important label is required since this definition overrides some of the
 *       definitions in the main Java-Doc Generated CSS File.
 *
 * CSSTags.java: public static final String CSS_ID_FOR_PACKAGE = "C02";
 */
DIV#C02
{
    color:          var(--Package-Label-Color);
    background:     var(--Package-Label-Background);
    font-weight:    bold;
    font-size:      120% !important;
    border-radius:  1em;
    display:        inline-block; /* don't use up entire screen-width */
    padding:        1em 1em 1em 0em; /* FIX-ME */
    padding:        0.5em 1.5em;
    margin-bottom:  1.5em;
    box-shadow:     inset 0 0 1em var(--Package-Label-Shadow);
}

/*
 * This is the MAIN TITLE AT THE TOP of the every Java-Doc CIET (Class, Interface,
 * Enumerated-Type, Annotation...) Page.  This is an HTML <H2> Element
 *
 * CSSTags.java: public static final String CSS_ID_FOR_TITLE = "C01";
 */
H2#C01
{
    color:          var(--CIET-Title-Color);
    background:     var(--CIET-Title-Background);
    font-size:      225%;
    font-family:    monospace;
    padding:        0.4em 1em 0.4em 1em;
    letter-spacing: 0.04em;
    overflow:       auto;
    border-radius:  1em;
}

/* Because of the color (used above, previous definition), this is needed to be visible */
H2#C01 A { color: lightskyblue !important; }

/* 
 * This is the "Inheritance Tree" that comes directly below the title, at the top of most
 * CIET pages.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_INHERITANCE = "C03";
 */
UL.C03 LI
{
    padding-left:   1em;
    line-height:    1.8;
    font-weight:    bold;
}


/* ********************************************************************************************* */
/* "HOVERING-SHADOW SIGNATURES" - <PRE> Element.  Top of page, and every DETAIL-SECTION element. */
/* ********************************************************************************************* */

/*
 * This is the "SIGNATURE" for all CIETs at the top of the page - there is ONLY ONE of these for
 * all Classes, Interfaces, Enums, Annotations....  This is the one at the top that has the
 * "Shadow Box" that outlines the signature with a shadow.  This is always an HTML <PRE> element.
 *
 * CSSTags.java: public static final String CSS_ID_FOR_SIGNATURES_HEADER = "C10";
 */
PRE#C10 
{
    border:         1px solid;
    padding:        1.2em 1em 1.2em 1em;
    box-shadow:     12px 12px 8px 0px var(--Signature-Shadow);
    margin:         1em 2em 2em 0em;
    overflow:       auto;
    font-size:      1.1em;
    font-weight:    bold;
}

/*
 * These are the method, constructor, field, enum-constant etc... "SIGNATURES" with "SHADOWS" at the
 * top of their respective DETAIL-SECTION.  This is the first line of every detail-defintion.
 * It is the complete SIGNATURE definition.  This is a box, that has a shadow, and it's contents
 * include the method return-type, the method-name, the parameter-list, any throws-clause, etc.
 * This is always an HTML <PRE> element.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_SIGNATURES = "C09";
 */
PRE.C09 
{
    border:         1px solid;
    padding:        1.2em 1em 1.2em 1em;
    box-shadow:     12px 12px 8px 0px var(--Signature-Shadow);
    margin:         0.5em 2em 2em 0em;
    overflow:       auto;
    font-size:      1.1em;
    font-weight:    bold;
}


/* ********************************************************************************************* */
/* Descriptions with a YELLOW-BACKGROUNDS:  Top of CIET, and every DETAIL-SECTION element.       */
/* ********************************************************************************************* */

/*
 * This is the name of the CSS ID that is added to the HTML divider ({@code <DIV>...</DIV>})
 * element at the TOP of the page for every CIET (Class, Interface, Enum,...) docoumentation-page.
 * This is the DESCRIPTION that is colored in LIGHT-YELLOW (top of page).
 *
 * CSSTags.java: public static final String CSS_ID_FOR_DESCRIPTION_HEADER = "C11";
 */
DIV#C11
{
    background:     var(--Top-Description-Background);
    padding:        1.5em 2em 1.5em 1.7em;
    border:         1px dashed var(--Top-Description-Border);
    border-radius:  2em;
    margin:         0em 2em 0em 0em;
}

/*
 * Primary LIGHT-YELLOW background behind every main-description divider (DIV) section for every
 * "Details Section" Element: method, field, constructor, enum-constant, and annotation element.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_DESCRIPTIONS = "C12";
 */
DIV.C12
{
    background:     var(--Detail-Description-Background);
    padding:        1.5em 2em 1.5em 1.7em;
}


/* ********************************************************************************************* */
/* NAME <H4> at the top of every DETAIL-SECTION element.                                         */
/* ********************************************************************************************* */

/*
 * This is the "NAME" of a specific "Details Section" Element: method, field, constructor,
 * enum-constant or annotation.  This makes the font a little bit bigger, and stand-out using the
 * CSS 'letter-spacing' definition.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_NAME_H4 = "C20";
 */
H4.C20
{
    color:          var(--Detail-Name-Color);
    background:     var(--Detail-Name-Background) !important;
    font-family:    Verdana, Arial, sans-serif;
    font-size:      165%;
    font-weight:    bold;
    padding:        0.5em 0.5em 0.5em 1.25em !important;
    letter-spacing: 0.085em;
    overflow:       auto; /* If they "spill-over", generate a slider bar */
    border-radius:  1em !important;
}


/* ********************************************************************************************* */
/* Defintions for PARAMETERS and <DD> explanations.                                              */
/* ********************************************************************************************* */

/*
 * This is the code that puts little light-green backgrounds on all the parameter-explanations.
 * Each of the method and constructor parameters "Stand Out" a lot more, and make the parameters
 * seem of a more important priority on JavaDoc Pages.  These are all wrapped in an HTML
 * <CODE> Element.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_PARAMETER_DEFINITIONS = "C05";
 */
CODE.C05
{
    color:          var(--Parameter-Color);
    background:     var(--Parameter-Background);
    padding:        0.1em 4em 0.1em 2em;
    border-radius:  0.5em;
    font-weight:    bold;
}

/*
 * This is the "DD" HTML Element that surrounds the parameter-definitions.  All this does is put
 * some space around the parameters - so to keep the definitions separated on the page.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_PARAMETER_DD_ELEMENT = "C06";
 */
DD.C06
{ 
    padding:        0.6em 1.5em 0.6em 3em;
    line-height:    1.8em;
}


/* ********************************************************************************************* */
/* Defintions for EXCEPTIONS and <DD> explanations.                                              */
/* ********************************************************************************************* */

/**
 * This is used for the exceptions listed in the "Throws" section.  It puts a 'black' backround
 * with light-green letters - THESE COLORS ARE THE "INVERSE" OF THE PARAMETER-EXPLANATION COLORS.
 * The exception's listed are wrapped in an HTML <CODE> Element.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_THROWS = "C07";
 */
CODE.C07
{
    color:          var(--Throws-Color);
    background:     var(--Throws-Background);
    font-weight:    bold;
    padding:        0.2em 3em 0.2em 1em;
    border-radius:  0.5em;
    letter-spacing: 0.08em;
}
CODE.C07 a:link, .C07 a:visited { color: var(--Throws-Anchor)       !important; }
CODE.C07 a:hover                { color: var(--Throws-Anchor-Hover) !important; }

/**
 * This is the name of the CSS Class that is added to the HTML '<DD>...</DD>' element for each
 * 'THROWS' (exceptions) on a Java Doc-Page.  This just provides some spacing, to make them 
 * explanations stand out a little bit.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_THROWS_DD_ELEMENT = "C08";
 */
DD.C08
{ 
    padding:        0.9em 1.5em 0.9em 3em;
    line-height:    1.8em;
}


/* ********************************************************************************************* */
/* Defintions for TYPE-PARAMETERS and <DD> explanations.                                         */
/* ********************************************************************************************* */

/*
 * This is the code that puts light-sky-blue backgrounds on all the type-parameter-explanations.
 * These are similar to method/constructor parameters, but they are listed at the very top of a
 * **GENERIC** Class or Interface.
 *
 * Each of the TYPE-PARAMETERS "Stand Out" a lot more, and this makes them consistent-looking
 * with the regular method/constructor parameters found elsewhere on the page.  This is also
 * re-used by the Type-Parameter's inside the Method and Constructor Details Sections, in 
 * addition to the Type-Parameter Definition's at the top of Generic Classes.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_TYPE_PARAMETER_DEFINITIONS = "C28";
 */
CODE.C28
{
    color:          var(--Type-Parameter-Color);
    background:     var(--Type-Parameter-Background);
    font-weight:    bold;
    padding:        0.1em 4em 0.1em 2em;
    border-radius:  0.5em;
}

/**
 * This is the "DD" HTML Element that surrounds the type-parameter-definitions.  All this does is
 * put some space around them - so to keep the definitions separated on the page.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_TYPE_PARAMETER_DD_ELEMENT = "C29";
 */
DD.C29
{ 
    padding:        0.6em 1.5em 0.6em 3em;
    line-height:    1.8em;
}

/*
 * Type Parameter Definitions as the top of the page do not need as much padding on the left.
 * The CSS Class "C04" is added to all <DL> elements that reside in the top description of the
 * page.
 */
DL.C04 DD.C29
{ padding-left: 1em !important /* Overrides definition in above line */; }


/* ********************************************************************************************* */
/* Detail and Summary Section <H3> CINZEL Headers                                                */
/* ********************************************************************************************* */

/**
 * This is the <H3> Element for every SUMMARY-SECTION and DETAILS-SECTION.  There are Summary
 * Tables and Details-Explanations for Methods, Fields, Constructors, Inner-Classes,
 * Enum-Constants, Optional Annotation Elements, and Required Annotation Elements.  This makes a
 * 'colored placard' for the main sections of a Java Doc Page
 *
 * CSSTags.java:
 *     public static final String CSS_CLASS_FOR_SUMMARY_SECTION = "C26";
 *     public static final String CSS_CLASS_FOR_DETAILS_SECTION = "C27";
 */
H3.C26, H3.C27
{
    color:          var(--Cinzel-Title-Color);
    background:     var(--Cinzel-Title-Background) !important;
    text-align:     center;
    padding:        0.4em 1em 0.4em 1em !important;
    font-size:      200%;
    font-family:    'Cinzel Decorative', monospace;
    font-style:     italic !important;
    font-weight:    700 !important;
    letter-spacing: 0.125em;
    overflow:       auto; /* If they "spill-over", generate a slider bar */
    border-radius:  1em;
}


/* ********************************************************************************************* */
/* Gray-Rounded Boxes: DETAILS-ELEMENTS "Labels" - *AND* Code-Hiliting, Static-Functinal, etc   */
/* ********************************************************************************************* */

/*
 * Some of these CSS Classes are included by the javadoc tool, itself, and are not from the
 * Upgrader Tool.  The original classes are left intact, not changed at all.  The other classes
 * listed were added by CSSTags.java.  They are all for the "Code HiLiting" sections.  All of
 * them are inside HTML <SPAN> elements.
 * 
 * ORIGINAL JAVADOC LABELS:
 *     "Parameters", "Returns", "See Also", "Throws", "Overrides", "Default"
 *
 * LABELS AT TOP OF PAGE (ALSO ORIGINAL):
 *      "Functional Interface Explanations"
 *      "Implemented-Interfaces (followed by a list)"
 *      "Direct Known Subclasses"
 *      "SuperInterfaces"
 *
 * HiLiteSrceCodeFile ADDED:
 *      .srcCodeLabel ("HiLited Source Code")
 *      .staticFunctional ("Stateless Class - The Spaghetti Report")
 "
 * CSSTags.java ADDED: LABELS for:
 *      "Exact Method Body"
 *      "Exact Constructor Body"
 *      "Exact Field Declaration Expression"
 *      "Exact Element Declaration"
 *      "Exact Constant Declaration"
 *
 * CSSTags.java:
 *     public static final String CSS_CLASS_FOR_CODE_METHOD_LABEL = "C15";
 *     public static final String CSS_CLASS_FOR_CODE_FIELD_LABEL = "C17";
 *     public static final String CSS_CLASS_FOR_ANNOTATION_DEFAULT = "C21";
 *     public static final String CSS_CLASS_FOR_CODE_ANNOTATION_ELEM_LABEL = "C22";
 *     public static final String CSS_CLASS_FOR_CODE_ENUM_CONSTANT_LABEL = "C24";
 *
 * NOTE: The "Code HiLiting" part for "Constructors" reuses the Method CSS Definition
 * a.k.a. "C15" and "C16"
 */
SPAN.paramLabel, SPAN.returnLabel, SPAN.seeLabel, SPAN.throwsLabel, 
    SPAN.overrideSpecifyLabel, 
    SPAN.simpleTagLabel, /* The "@since" Taglet uses this CSS Class, among others */
    SPAN.C15, SPAN.C17, SPAN.C21, SPAN.C22, SPAN.C24,
    SPAN.srcCodeLabel, SPAN.staticFunctional, SPAN.headerLabel
{
    color:          var(--Detail-DDDT-Color);
    background:     var(--Detail-DDDT-Backgrund) !important;
    padding:        0.8em 1em 0.8em 1.5em;
    margin:         1.6em 1em 1.6em 0em;
    font-size:      1.1em; 
    font-family:    'Cinzel Decorative', monospace;
    font-style:     italic;
    font-weight:    900 !important;
    letter-spacing: 0.125em;
    display:        block;
    border-radius:  1.5em;
    text-shadow:    0px 0px 5px  var(--Detail-DDDT-Shadow),
                    0px 0px 10px var(--Detail-DDDT-Shadow),
                    0px 0px 10px var(--Detail-DDDT-Shadow),
                    0px 0px 20px var(--Detail-DDDT-Shadow);
}

SPAN.paramLabel, SPAN.returnLabel, SPAN.seeLabel, SPAN.throwsLabel, 
    SPAN.overrideSpecifyLabel,
    SPAN.simpleTagLabel, /* The "@since" Taglet uses this CSS Class, as do others */
    SPAN.C15, SPAN.C17, SPAN.C21, SPAN.C22, SPAN.C24
{ width: 12em; }

SPAN.srcCodeLabel, SPAN.staticFunctional, SPAN.headerLabel,
    DL.C04 DT SPAN
{ width: 20em; } 

/**
 * This just pushes forward the "All Implemented Interface" and "Known Direct SubClasses"
 * Banner/Labels to the right a little bit.  This is just for spacing.  It also works on
 * all the Heading-Banners.  A 'C04' class is inserted into all of the <DL><DD> elements at
 * the top of a Java Doc Page.   (It takes care not too insert them into ones that the user
 * may have put inside the Yellow-Box Description)
 */
DL.C04 DD { margin-left: 1em !important; }

/*
 * These are the <DD> elements for code-hilited Method-Bodies, Constructor-Bodies,
 * Field-Declarations, Enum-Constant Declarations, and Annotation-Element Declarations
 * These are currently used to provide MARGIN-SPACE only!
 *
 * CSSTags.java:
 *     public static final String CSS_CLASS_FOR_CODE_METHOD_DEFINITION = "C16";
 *     public static final String CSS_CLASS_FOR_CODE_FIELD_DEFINITION = "C18";
 *     public static final String CSS_CLASS_FOR_CODE_ANNOTATION_ELEM_DEFINITION = "C23";
 *     public static final String CSS_CLASS_FOR_CODE_ENUM_CONST_DEFINITION = "C25";
 *
 * NOTE: The "Code HiLiting" part for "Constructors" reuses the Method CSS Definition
 * a.k.a. "C15" and "C16"
 */
DD.C16, DD.C18, DD.C23, DD.C25 { padding: 0.5em 1em 0em 1em; }


/* ********************************************************************************************* */
/* "RETURNS" <DD> Elements: Just the Padding                                                     */
/* ********************************************************************************************* */

/*
 * This is the <DD> element for the "Returns" section of a method.  There is a paragraph that
 * describes what a method returns.  This is just playing with the 'padding' so it is better
 * centered / located on the page with respect to the other items in a "Method Detail" Section.
 *
 * public static final String CSS_CLASS_FOR_RETURN_DD = "C19";
 */
DD.C19 { padding: 0.3em 3.5em 0.3em 3em; }


/* ********************************************************************************************* */
/* "SEE ALSO" <DD> Elements: Putting the listed items onto separate lines using CSS              */
/* ********************************************************************************************* */

/*
 * This is the "See Also" section.  These are the "see also" anchors and codes...
 * The 'display: block' addition puts them on separate-lines so the links stand out more!
 * 
 * NOTE: If you prefer to have the SEE-ALSO section for Methods, Constructors, Fields, Enum-Types,
 * etc... as the originally were created by JavaDoc - where each item is on the *SAME LINE*
 * separated by commas - then replace these definitions with empty braces "{ }", or delete them
 * altogether.
 *
 * CSSTags.java: public static final String CSS_CLASS_FOR_SEE_ALSO = "C13";
 */
CODE.C13, A.C13
{
    font-weight:    bold;
    display:        block;
    padding:        0em 0em 0em 1.5em;
 }
 
/*
 * This is, literally, just the comma between "See Also" sections.  It is a difficult-to-describe
 * trick to prevent showing the commas when "See Also" directives are displayed line-by-line.
 * Could be changed, later....  An HTML <SPAN> element was added.  This is a hack.
 *
 * CSSTags: public static final String CSS_CLASS_COMMA_SEE_ALSO = "C14";
 */
SPAN.C14 { display: none; }


/* ********************************************************************************************* */
/* "Overrides" and "Specified By" <DD> Elements: Just the Margin                                 */
/* ********************************************************************************************* */

/*
 * The "Overrides" and the "Specified By" need to be indented to be consistent looking with the
 * rest of the entries in a "Details Section" 
 *
 * AGAIN: The CSS !important key-word is required to override the Java Doc generated CSS File.
 *
 * public static final String CSS_CLASS_FOR_OVERRIDE_SPECIFY_DD = "C30";
 */
DD.C30 { margin-left: 3em !important; }