Web Site Design

Tom Van Vleck

The Multics website was begun by Tom Van Vleck in 1994. After 19 years, it has grown to 229 HTML files comprising over 1,000,000 lines, thanks to the contributions of many Multicians. This page is a guide for maintainers of the Multicians web pages.

• Design Refresh. new The multicians.org website had a substantial design refresh in Oct-Nov 2012. All pages were reformatted, in many cases by changing the wrapper macros only.
  • Redesigned home page: wider, more open layout with larger print. Simplified the home page generation. Eliminated home-brew indexing, used Google custom search instead. Removed random picture picker and its iframe, added a JQuery based picture gallery using EasySlider. Removed long disorganized list of contents that duplicated the menus. Many thanks to Lilli Filichia for design and layout advice.
  • Provided one-level drop-down menus on almost all pages, generated from menubar.sql, shown using JQuery. Only one level (ie no staircase). If JavaScript is not enabled, the menu degrades to single menubar. The tail of every page has links to the other L2 pages in the category, and all pages have links to the L1 category heads, so that there is a path to all pages if the menus are not working.
  • Reorganized the menu headings and categories: History, People, Library, Sites, About. Moved some pages from Stories to Articles. Eliminated general.html, moved its parts elsewhere.
  • Converted all pages to HTML5. Improved layout of image gallery and some other pages using images.
• multicians.org
  • This site is provided by the editor, who pays the domain registration fees and web hosting fees as a contribution to the online community.
  • We are limited in both storage space and bandwidth as a result. The editor will take whatever steps are necessary to avoid exceeding the (fairly high) limits imposed by the ISP, since this could cost the editor a lot more money than he can spare.
  • The current ISP (Pair networks) has a fairly reasonable policy on "slashdotting" but more than one in a month could be a problem.
  • We are also bound by the AUP of the ISP. So far this has not been a problem.
  • The advantages of hosting at the current ISP are very high bandwidth and redundant connectivity, very good server response and uptime, reasonable prices, outstanding policies and facilities, and 24 hour technical support. The ISP has been in business since 1996 and says it does not plan to change management, merge, or be sold.
  • The ISP supports virtual domain hosting, CGI and CGIWRAP usage, custom mail forwarding with procmail, server log extracts, SQL database access, cron, SSH and SCP for updating, shadowed backup, FTP, and other features that not all ISPs provide.
• Tone
  • This site is about content. The goal is to present the story of Multics for people interested in the system's history, especially Multicians. Humor is OK but excess is not.
  • Aim for an informal, yet accurate tone.
  • Clearly mark individual opinion and distinguish from verified fact. Prefer first-hand accounts of individual experience.
  • Present consistent look and feel.
  • Appearance should be polished but not glitzy.
    • No gratuitous animation, sound, background, etc.
• Audience and goals
  • Multicians
    • Remember good times.
    • Give credit where it is due.
  • Students of operating systems
    • Learn from failures.
    • Learn from successes.
    • Point the way forward.
  • General public
    • Explain what Multics was and why important.
    • Do their homework for them.
  • Historians
    • Provide accurate facts.
• Content
  • Keep high standards: correct spelling, reformat, fix up GIFs.
  • Credit every source.
  • Ensure that intra-site navigation works and is consistent.
  • Ask permission before publishing others' writings.
  • Inform foreign page owners if linking to them. Check occasionally for dead links.
  • Ask permission before adding a person's mail address to the database backing multicians.html.
  • Try to avoid judging the value of others' contributions.
    • If they say they're a Multician, and made some contribution, list them.
  • Pictures
    • Pictures interest people. Use plenty.
    • Small as reasonable, for loading speed. Put bigger version "behind" for more detail.
    • GIFs or JPGs. Old MSIE browsers cannot handle PNG or SVG.
    • High contrast and brightness (pictures get darker on web, gamma may differ).
    • Remember that not all systems have same DPI or number of colors.
    • Use JPGs for photos. Don't worry about palette conflicts.
    • See my article on how to use Photoshop.
  • Original documents. This site is a repository for documents not available elsewhere.
    • Scan and convert these to HTML so they are fully searchable. (Image-only PDFs are a bad idea.)
    • Do not attempt to preserve visual fidelity with originals, e.g. two column layout. Concentrate on readability and availability for other use.
    • Redraw figures if necessary.
    • Attempt to secure copyright clearance and permission of author.
  • Ensure that dates are included in many items, so that the reader understands when each part of the story happened.
• Implementation
  • Generate HTML files statically offline.
    • More efficient on server.
    • Stratus mirror site is FTP only, cannot execute any server side code.
    • Factor common elements into include files for maintenance ease and consistency.
    • Generate pages from database if this simplifies processing.
  • Write legal standard HTML that works OK in popular browsers.
    • Only one H1 per document.
    • Use Hx controls to represent outline structure, not for text format.
    • Run W3 Validator on every file we control; should validate as HTML5. updated Fix all reported problems.
      • Although the validator says the BORDER=0 attribute is obsolete, continue to use it because MSIE will not pick it up from the CSS.
    • Use macro tools to generate as much HTML as possible, in order to avoid errors.
    • Use JQuery drop-down menus on all pages. new
    • Try to look good in MSIE 7, 8, and 9. IE5-6 are rare.
    • Do not use HTML produced by MSWord "Save as HTML." It's full of constructs that only work right on MSIE.
  • Be usable by text-only browsers and non-image-loaders.
    • Graphic images must have ALT=
    • Use tables for tabular data, not for presentation.
    • Do formatting and layout in CSS.
    • Perform accessibility checks occasionally and try to deal with issues.
    • Degrade gracefully, e. g. still show useful info if Javascript is off.
  • Avoid proprietary formats.
    • Convert Word, etc to HTML.
    • Convert PowerPoint, etc to PDF.
    • (Exception: binary tools for reading Multics tapes.)
  • Look good in most browsers.
    • Don't use features that make the page unintelligible in many browsers, e.g. ActiveX.
  • Look as good as possible in Mozilla, Chrome and IE.
    • On average, 21% of hits are from Mozilla, 27% from MSIE, 22% from Chrome, 9% Safari (3/2013).
    • OK to use MSIE conditional expressions to compensate for its non-standard behavior (example: CANVAS support).
  • Display as fast as possible.
    • Every IMG should have HEIGHT and WIDTH, generated if possible.
    • Small to medium graphic images.
    • No backgrounds.
    • GIFs larger than icon size should be interlaced.
    • Break files >50K into smaller ones, if this can be done without inconvenience to the reader. (Multicians list, bibliography, source index are all kept integral because having things in one place is more useful than having a file that loads quickly. The glossary, on the other hand, is broken into a file per letter.).
    • Not too many graphic images on a page. The first time a page gets slashdotted and you see one hit for the page, and 20 for decorative graphics, will teach a hard lesson.
  • Don't require plugins or client side execution.
    • No shockwave, PNG, SVG, etc (requires plugin on most browsers).
    • No ActiveX (won't work with non-Microsoft browsers).
    • No Java (many users disable due to security issues, startup is slow).
    • JavaScript is allowed if the page is still usable when it is turned off (user may disable). Stick to features available on most browsers. (Uses: menu drop-downs, picture sliders and lightboxes, validation of mail form submission (uses NOSCRIPT), AJAX in mail form and signup form.)
    • jQuery is acceptable (used on 50% of commerce sites). It simplifies browser variation coding. new
    • No rollovers (bandwidth, gratuitous). Use of HOVER (menus, links) is OK, but remember that tables and mobile phones donot have it.
    • No Flash (bandwidth, gratuitous).
  • Stratus mirror is FTP only.
    • Can't use server imagemaps, servlets, or PHP.
    • Can point to CGI scripts on servers that do support it; for example, the mail sending facility points to CGIs at www.multicians.org.
  • Links.
    • Use descriptive link text.
    • Links offsite should be preceded by an icon and have a descriptive TITLE and open in a new window. Use the brace-exclamation syntax to generate links via the external link table, or invoke the macros bitsaversmultics, mitsourcearc, mitsourcefile, or mitinfoseg. Exceptions: no icon on outbound links from multicians.html (size, speed).
    • Links to website files should have TITLE attribute generated by the brace-at syntax via the pages table, providing a tooltip identifying the target.
  • Help user find what's new or interesting.
    • Provide a date modified in heading at the top of every page. Use "date content modified" in preference to file date so that maintenance does not mislead user.
    • Flag new items with new flag, updated ones with updated . (Done with styled text to save an image load.)
    • Maintain the change log and RSS feed describing content changes.
  • Cross-link pages.
    • Links should add to the reading and understanding experience.
    • In general, don't link to the same target more than once from the same area on a page. For instance, the Changes page links to each modified page once, not once for each change. But the Changes page also has a standard navigation panel that links to all pages.
    • Link terms to the Glossary.
    • Link names to the Multicians list.
    • Link to other pages as possible.
  • Many pages will be found by search engines. Every page is a front page.
    • Make sure every page is self-explanatory, so a user knows what it is part of and what it's about. Users will enter the site at many places besides the front page, and need context.
    • Include a META KEYWORDS and META DESCRIPTION on every page, to ensure that the search engines point to the pages they should and give the user an idea of what is on the page.
    • Ensure that navigation is rich: from every page, one should be able to find the pages a reader might want to go to next, especially the main page.
  • Cascading Style Sheets (CSS)
    • Use HTML for structure, style sheet for layout. For example, don't use extra P or BR tags for layout, place the item in a container with a CLASS attribute and control the class's layout. (This page is an example. The spacing after top-level LI tags is done via a CLASS attribute and a CSS definition.)
    • Tag items with semantic attributes, e.g. pathname, webpage, toplevel, rather than presentation attributes like bold or tiny.
    • All pages should use the standard mxstyle.css. Styles that pertain to a single page can be in a STYLE block on the page.
    • Vast majority of the hits on the site are from CSS capable browsers. Make sure every page is intelligible with and without CSS.
    • Don't use FONT FACE attribute (deprecated), rather STYLE section and SPAN attribute.
    • Some CSS features don't work in all browsers. Stick to those that work in Mozilla, Chrome, and Microsoft.
    • CSS hacks may be needed to enable good presentation. Restrict these, keep then in a few include files only, check them when new browsers are released.
      • Currently the site uses the !IMPORTANT attribute, ignored by MSIE, to mark values for Firefox and Opera, followed by the MSIE value. This construction works for MSIE 5-7 in Quirks mode.
      • The major problem with MSIE layout is its incorrect calculation of box width and height; MSIE includes the border and padding of items in the value, so the MSIE size should be bigger for padded items.
      • MSIE also does not support MAX-WIDTH, used to control page width.
    • Check printing a CSS page as well as displaying it. Some browsers display OK but mess up on printing. A PRINT style is set in the CSS that suppresses the printing of navigation elements.
  • No Frames.
    • Frames are nonstandard.
    • Navigation on frames pages is confusing or buggy in some browsers.
    • Framed pages need extra care to make sure there's no route that shows them unframed.
  • No animation (exception for interesting technical use).
  • No blinking text.
  • Classes of pages:
    • Class 1: head page. Black box at top with logo, drop down menu nav just below. The head page serves as the site map and main index to pages. Since many users never scroll down, the drop down menus make most content accessible without scrolling, in order to draw users deeper into the site. (This seems to work based on navigation patterns in the log.)
    • Class 2: black box at top with logo, drop down menu nav just below. (Text links for navigation are used throughout the rest of the site to speed download time.) For pages with a list of things, put total count in col 3 of the standard header, below the date. These pages are formatted via the wrapper macros described below.
    • Class 3: paper, story, etc, formatted by editor. Black bar and red menu bar.
    • Class 4: formatting supplied by some other author. Add navigation links to head page and all tier 2 pages at bottom, optional mxstyle.css
  • Spelling and orthography decisions:
    • Unix, not UNIX (except in direct quotes and titles of books, etc). Source: Dennis Ritchie.
    • Database vs data base: both occur, should decide.
    • Timesharing vs time-sharing: both occur, should decide.
    • Online vs on-line: both occur, should decide.
    • Mail vs e-mail vs email: all occur, should decide.
• Each page's organization
  • Each page has a TITLE and H1 (generated by macros).
  • Each page has ADDRESS containing a link to editor (generated by macros).
  • Record content changes in loadc.sql with date (generated from loadc.sql).
  • Title of page and H1 should be self explanatory.
  • All pages have white background, black text from style sheet.
  • Almost all pages have all content inside a DIV with MAX-WIDTH set by an include file, to maintain readability on wide monitors. The content is also centered on the screen. A CSS hack ensures that a fixed width is provided for MSIE, which does not recognize MAX-WIDTH. Since tables are not used for width control, the pages print correctly and display OK in small windows. (Check that this still works as new browsers are announced.)
    • Exception: very long and wide pages, such as the Multicians list.
  • Navigation updated
    • Link to head page and all tier 2 pages always provided. Red menu bar is used almost everywhere.
    • glossary: alphabetical index, list of topics, forward link.
  • Pages with a single author list it at top.
  • Date modified at bottom for story pages.
  • Mail link for editor at bottom of each page uses the mail form sending mechanism described below.
• Where different kinds of information goes updated
  • Home Page is an introduction.
    • General blurb.
    • Site into.
    • Search box.
    • Announcements.
    • Picture slider, pictures link to important pages.
    • Changes box, generated when changes page is expanded.
  • History contains historical information.
    • History (history.html) (tier 2 page)
      • xref people to multicians.html.
      • xref terms to glossary.
      • xref sites to glossary.
    • Myths (myths.html) (tier 2 page)
      • xref people to multicians.html.
      • xref terms to glossary.
      • xref sites to glossary.
    • Features (features.html) (tier 2 page)
      • xref people to multicians.html.
      • xref terms to glossary.
      • xref sites to glossary.
    • Dates (chrono.html) (tier 2 page)
      • every date known. Non-Multics events in italics.
      • site biographies: every date for this site.
      • site-timeline.html: every date for every site, plus a few major events.
    • Glossary (tier 2 page, generated from g1.sql)
      • xref people to multicians.html.
      • xref terms to glossary.
      • xref sites to glossary.
      • terms not beginning with a letter go in mga.html.
      • long articles go elsewhere: link to them from glossary, e.g. descriptions of features go in features.html, and glossary should have a short summary and a link.
  • People has information about Multicians.
    • Multicians (multicians.html) (tier 2 page, generated from loadm.sql)
      • don't xref terms to glossary, makes it too big.
      • don't xref sites, makes it too big.
      • Mail links invoke a CGI that generates a mail form sending page.
        • If Javascript is enabled, perform an XHR request to check that the sender is entering a valid return address.
        • Form submission invokes mail sending CGI, which enforces anti-abuse restrictions.
        • Mail sending CGI sends to receiver's mail address from the m table on www.multicians.org.
    • Stories (multics-stories.html) (tier 2 page)
      • TOC for the stories, automatically generated from loadpages.sql, by date, author, and site.
      • Links to each story.
      • Individual stories each get a class 2, 3 or 4 file. Classes 2 and 3 xref people, terms, sites.
  • Library is reference information hosted at the site.
    • Bibliography (biblio.html) (tier 2 page, generated from loadbib.sql)
      • don't xref people, terms, sites (too big).
      • If a referenced paper is online, link to it (globe for external links).
    • Development documents (devdoc.html) (tier 2 page)
      • Section for each document type, with DL linking to and describing docs.
      • links to each doc give size, date, #pictures.
      • individual docs xref people, terms, sites.
    • Papers (papers.html) (tier 2 page)
      • Chronological order, with DL linking to and describing paper.
      • links to each paper give size, date, #pictures.
      • individual papers xref people, terms, sites.
      • If a referenced paper is online, link to it (globe for external links).
      • If you add a paper, remember to also add it to loadpages.sql and loadbib.sql
    • Articles (articles.html) (tier 2 page)
      • Technical articles about Multics features, not elsewhere published.
      • links to each doc give size, date.
      • individual docs xref people, terms, sites.
  • Sites is information about specific sites.
    • Sites (sites.html) (tier 2 page, generated from loadsites.sql)
      • link to glossary if any info, link to site bio if exists.
      • site biographies: long stories, link to external site.
      • glossary: link to external site, link to site bio if exists.
      • site-timeline.html: generated by perl program from site-timeline.txt.
  • About is about the website itself, and Multics today.
    • Changes (changes.html) (tier 2 page, generated from loadc.sql)
      • Link to file that changed generated by template.
      • List counts for multicians, bibliography, glossary, sites.
      • Current year only; prior years go into changes-old.html
    • Links (mult-links.html) (tier 2 page)
      • Sections for different classes of offsite links.
      • Use loadext.sql to create external links.
      • Offsite links may also be placed in other documents; use judgment whether to duplicate on the links page.
      • Do not duplicate homepage links for Multicians on the links page.
    • News (multics-news.html) (tier 3 page)
      • News events other than website news.
    • Image Gallery (multics-images.html) (tier 3 page, generated from multhumbs.sql)
      • Thumbnails of images on the site, linking to pages where they are used.
      • Fluid layout.
    • Site Map (sitemap.html) (tier 3 page, generated from loadpages.sql)
      • One entry for each page on the site.
• Site Maintenance updated
  • Source for most pages is in the HTMX language. It is translated to HTML by the expandfile tool.
  • Translation is invoked using the Unix make command for any file whose source is newer than its object.
  • After translation, the Makefile invokes HTML Tidy to warn if there are errors. Cure these and re-install.
  • When an image is added to any page, remember to add it to multhumbs.sql and generate a thumbnail for it in the thumbnails dir using hthumb or vthumb. The imgtag, imgdiv, and imgpopdiv macros generate references to images.
  • For a single image, use the imgdiv or imgtag macro.
  • For a single image that sends you to another page when clicked, use the imgdiv macro.
  • For a single image that pops up a lightbox when clicked, use the imgpopdiv macro. Include use-dhtml-lightbox.htmi in the EXTRASTYLE block, and include dhtml-lightbox.htmi at the top of the BODY block.
  • For a set of image thumbnails that pops up a lightbox with next and previous controls when clicked, include uselightbox.htmi (see the comments at the top of it) in the EXTRASTYLE block, and invoke the lightBox function mentioning the ID tags of DIVs containing a UL of thumbnails that link to full-size pictures.
  • Use the bitsaversmultics macro to generate references to scanned Multics manuals at bitsavers.org.
  • Use the mitsourcefile and mitsourcearc macros to generate references to Multics source at MIT.
  • Generate external links using {!tag text!} which looks up "tag" in external links table and inserts globe icon and TITLE tag.
  • Generate multicians links using {[tag text]} which looks up "tag" in multicians table and inserts TITLE tag.
  • Generate glossary links using {{tag text}} which looks up "tag" in glossary table and inserts TITLE tag.
  • Generate internal links using {@tag text@} which looks up "tag" in pages table and inserts TITLE tag.
  • Use {:text:} for "cmd", {=text=} for "pathname", {+text+} for "code", {*text*} for "source file".
  • To update main page:
    • Edit multicians.htmx in the source directory.
    • make install
    Main page is automatically updated if many other pages change. See Makefile.
  • To add or update a Multician:
    • User may use the form at mform.html
      • If user has Javascript enabled, an XHR request is sent to www.multicians.org to check if supplied e-mail address is reachable.
      • If user has Javascript enabled, an XHR request is sent to www.multicians.org to look for an existing database entry in the m table.
      • Form submission invokes mxregister.cgi at ISP, which sends mail to maintainer with database input.
    • User may also send a mail message to the editor.
    • Verify info and add or update row in loadm.sql in the source directory.
    • If the person has won an award or medal, add or update row in mxawards.sql in the source directory.
    • make transmits an updated copy of the m table to www.multicians.org for use in mail sending and Multician registration.
    • make install transmits an updated copy of the procmail mail redirector script multicians.procmail.
  • To add or update an offsite link:
    • Links go in loadext.sql, loadbib.sql, or loadm.sql.
    • Edit loadext.sql to add or modify a row in the external links table and reload it.
    • Add a reference to the place where the link goes. Globe icon, etc will be generated by expandfile.
    • make install
    • Check every few months for dead links using checkext.
  • To add or update site information:
    • Verify info and add row or update in loadsites.sql in the source directory.
    • If new dates are added, fix site timeline datafile site-timeline.txt by hand.
    • make install
  • To add or update bibliography:
    • Verify info and add or update row in table "biblio" loadbib.sql in the source directory.
    • Verify info and add or update rows in "authors" and "aka" tables. (Should automate this.)
    • make install
  • To add or update glossary entries:
    • Edit or add paragraphs to g1.sql in the source directory. Use special tags to generate links to glossary entries and Multicians list entries, and to mark commands, pathnames, and code. One oddity: to insert a backslash in the output, you have to put EIGHT backslashes in the database file, cause it gets expanded three times.
    • make install
  • To add a new story:
    • Add the HTML body to a new file storyname.htmx in the source directory. Use the wrapper macros.
    • Do the other "new page" operations below. Adding the page to loadpages.sql with a "site" entry triggers its inclusion in the stories index.
    • make and then use W3 validator to check the new file.
    • make install
  • To add or update other class 2 and class 3 pages:
    • Edit or add filename.htmx in the source directory. Don't edit the HTML files directly.
    • Use wrapper macros: set title, description, keywords, and headingdate, then define a block called body (and optional blocks extrastyle and extratail), and then include pagewrapper.htmi. This will take care of all standard heading and tail matter.
    • Use the imgtag, imgdiv or imgpopdiv macro for references to images. Update multhumbs.sql and make thumbnail for new images.
    • When a new page is added,
      • touch the .html page in the object directory to cause make to start creating it.
      • touch makemxtarextrafiles.
      • add a row to loadpages.sql to put it into the site map. Set the nextstory field of an existing page to point to this one, and the nextstory field of the new entry to the old value, so "Next Story" link works. (Touch the source of the existing page so it will be regenerated also.)
    • Decide if the page should be listed on in the menus, and update if so.
    • make and then use W3 validator to check the new file.
    • make install
  • To add or update class 4 pages (formatted by others): either convert the file to a class 3 page, or
    • Place the file directly in the object directory. Edit it to insert navigation to the rest of the site at the bottom.
    • Add its name to loadpages.sql and makemxtarextrafiles in the source directory. Optionally add mxstyle.css for uniform heading styles if this doesn't mess it up.
    • Change mail addresses to links to the Multicians page.
    • make install
  • Run W3 Validator on each new class 1-3 file. It checks for more errors than HTML Tidy.
  • Update loadc.sql and make install to generate changes.html describing what's new. Changing this file will also regenerate the HTML site map and Google sitemap.xml.gz files.
  • make install completely regenerates the keyword index. For cases when you don't need to re-index the site and want a quick install (e.g. you are connected on dialup) do make q instead.
  • On hosting site, tar up using make_mx_tar and send to mirror sites using shell script tarsend every month or so.
• Smoke Test new . Check major updates in Firefox/Mac, Safari/Mac, Chrome/Mac, MSIE8/Win7, MSIE7/WinXP. Check when new browser versions of Firefox and MSIE are released.
  • multics.html: menubar looks right, menus drop and look right, slider works, looks OK on window resize, print preview looks OK.
  • about.html, biblio.html, site-timeline.html: look OK. sites.html hovers work.
  • Do a Google search for something.
  • Test sending mail to editor and using the signup form.
• Details to Check When Deploying on Host
  • Symlinks: index.html -> multics.html, plain.html -> multics.html, thvv -> ../thvv, Geo -> ../Geo.
  • Directory mxs contains the source. It should have password access controlled via .htaccess.
  • Subdirectory admin is a future tool. It should have password access controlled via .htaccess.
  • Machinery files in cgi-bin.
  • Contents of .htaccess. Redirects: some files have alternate names or are always looked for in wrong dir. Picture stealing control: references to JPG or GIF files that do not have a valid referrer field are denied with a 403 Forbidden error code.
  • Special files favicon.ico, robots.txt are present.
• multicians.org mail reflector maintenance
  • The procmail script multicians.procmail in home directory of the account hosting multicians.org redirects selected mail messages.
  • The redirector script is automatically generated by expandfile with procmail.tpt from the multicians table by the Makefile when loadm.sql is updated.
  • If a new multicians.org address is added, add it to the list of valid entries in the ISP's mail recipe control panel.
  • See multicians-org.html for details.
  • We are trying to phase this facility out since the ISP may not support it forever.
• alt.os.multics FAQ Maintenance. At some point we will stop doing this.
  • Post the FAQ to alt.os.multics on (or after) the first of each month.
    • Short FAQ 12 times a year, one file.
  • To post the short FAQ, run make auto2
• Wish list, future tasks
  • Pages to write
    • hardware page
    • architecture page
    • B2
    • Comparison between Multics and Unix
    • Security stories
  • Generate site timeline from sites table.
  • Write a management form page, backed with CGI, to do maintenance tasks:
    • Add/update user in m (checking mail addr and url)
    • Add document to biblio, linking authors to m via aka (operate on db table and then dump it to ASCII with mysqldump)
    • Add a new page, updating pages (run HTML Tidy, then transform to create .htmx source using page wrapper)
    • Add new story, updating pages
    • Add new glossary entry (scan the entry for possible crosslinks)
    • Add/update offsite link (checking that it's there)
    • Add image (add to mulctl.txt and make thumbnail)
    • Check external URLs and mail addresses for validity.
    • Check for extra and missing files.
    • Run W3 validator on all HTML.
    (This begins to look complicated, reinventing content management.)
  • Put source of the website into a subversion or git repository.
  • Figure out discipline for multiple site maintainers.
    • Use Multics model, i.e. pull not push.
    • Release branch in repository is owned by editors.
• Tools needed to maintain Multics site provided by others: updated
  • Perl language
  • Remote copy command rsync
  • Remote access commands ssh or PuTTY
  • Unix commands make, touch, chmod, diff, cp, cat, ls, echo, mv, sh, grep, sed, gzip
  • SQL (MySQL), including command line interface and Perl DBI (currently no version 4/5 features are used)
  • HTML-aware text editor, such as emacs
  • Photoshop or Gimp
  • Optional: ImageMagick tool convert
  • Optional: HTML Tidy (HTML5 version)
  • JQuery 1.8.2. - http://jquery.com
  • EasySlider 1.7. Alen Grakalic - http://cssglobe.com/post/4004/easy-slider-15-the-easiest-jquery-plugin-for-sliding
  • jquery-lightbox-0.5.js Leandro Vieira Pinho - http://leandrovieira.com
• Tools needed to maintain Multics site provided by editor: updated
  • HTMX language (Perl): expandfile, thvve.pm, thvvutil.pm
  • HTMX Site macros and templates
  • MySQL schemas
  • Configuration file config.txt
  • HTMX helper programs (Perl): filemodshort, dbcounts, filesizek, nargs, filedaysold, filedmodiso, checknonempty, gifsize
  • Special page generators (Perl/SQL): printgloss3.pl, printsites2.pl, gen_site_timeline.pl, gallery4.pl, printmulticians3.pl, countauth.pl
  • USENET postings: auto1a.sh, post.pl
  • Single picture lightbox: dhtml-lightbox.js
  • Drop down menus: ddm.js
• Programs and data files in cgi-bin directory provided by editor:
  • Configuration file mxconfig.txt
  • mxmail.cgi, mxmailform.cgi, ckem.cgi
  • mxregister.cgi, mxregister4.cgi
  • Template files for mxmail and mxregister
  • special.pmrc for spam checking messages sent from the web form, using procmail
• Programs and data provided by web host: updated
  • Apache web server, inclding .htaccess support, NCSA combined web log, CGI Perl execution, DEFLATE.
  • cgiwrap support
  • procmail support for incoming mail and forwarding
  • Shell access via ssh
  • scp/rsync access
  • SQL (MySQL), including command line interface and Perl DBI and CGI execution.
  • Optional: geolocation database