Returning to the Moon: Guidance Calibration

With images working on the Spanner Wingnut blog, there is now regular posting there.  I have begun adapting test pages from the hexo-theme-unit-test source.  I don’t use the recommended procedure though.  Instead, I have cloned the unit-test repository to its own location, and I cherry-pick the test pages from there.

Once I have transposed a test page into the spanner authoring folders, I first confirm that the test cases are all satisfied.  Then I make further adjustments that may be needed to satisfy my feature/formatting requirements.  That happened, for example, where I simplified formatting of block quotes.

I continue to find bread crumbs leading to where changes can be made by following the theme customization examples of John Stevenson.

In my case, I improved treatment of block quotes by removing features deep in themes/landscape/source/css/_partial/article.styl

Under the article.styl for blockquote CSS, the font-family, font-size, and text-align properties are commented out so that the prevailing formatting work.  Only the margin change is retained, introducing the indentation of margins

Test page adjustments reflect the successful change.

Additions to the blockquote paragraph confirm propler line wrap of the indented block and also that multiple block-indent levels are handled

I treat block “quote” and block-indentation as the same.  The simplified formatting allows for that and preserves multiple block indentation as well.  When the special case of quotation is intended, I will signal that by other means.

As the Spanner Wingnut blog generation improves, more about these customization will appear there, with no need for further attention on a separate blog.  It is not quite soup yet.

Posted in Blog Development, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , | Leave a comment

Returning to the Moon: Over-Tightened Wingnuts

The Spanner Wingnut blog is now being published with Hexo-generated content.  That version is the current default.  Technically, the Returning to the Moon topic could continue there.  that is the appropriate place for preservation of all the findings of my experimental efforts.

Of all the features and provisions that require more preparation, the one blocker against full use of Spanner Wingnut is incorporation of images

A benchmark case for this just fell into my lap.   It is, to my amazement, about wingnut.  In In the Ghost Recon Wildlands game, Orcmid's character just earned the "wingnut" helmet while playing solo at Tier solo play of the Tier One campaign level in Tom Clancy’s Ghost Recon Wildlands, I just earned the Wingnut Helmet.   No kidding.

My Orcmid character will not wear that helmet.  It reminds me of a haircut style ending in the early Beatles era.   One 1970s friend who sported it earned Hugh J. Rundle’s appellation as “Mrs. Morse’s son, Helmet.”

Acquiring that helmet brought reminiscence of all of that.

It also provides a test formatting for the screen-captured image.  I’ll endeavor to replicate something like these in my next round of updates to the Spanner Wingnut blog.

The Orcmid character in the standard campaign progression has different headgear and scarf.  Oddly, the hat is very similar to one that I own and wear.  The Ghost Recon naming of this hat is “Boonie.”  Hmm.  Mine was a gift, it has a great chin strap for windy Seattle weather, and it came pre-distressed, although I often roll it up and stuff it in a sleeve.

The floppier hat that orcmid prefers in the game is known as the Boonie.  It is favored because of one that the player wears regularly in real life

Here, Orcmid also sports his favorite assault rifle, with grenade launcher at the ready.  This definitely goes with the 100% tactical playing style that I have developed for near-close combat.  At other times, perhaps the most dangerous weaponry of this Ghost involves his explosive-equipped drone and precision sniping by his able team.

Standard for Orcmid is a sniper rifle and grey hair with poneytail.  In the Fallen Ghosts campaign, a Western hat similar to one the player also owns

In the Fallen Ghosts campaign feature of Ghost Recon Wildlands, it was necessary to design a new character.  I did what I could to have this Orcmid match the existing one, except for the Western hat.  I would enjoy serious gray hair, but this is the closest gray provided.  The pony tail helps though.

Posted in Blog Development, Golden Geek, Spanner Wingnut, Toolcraft, Uncategorized | Tagged , , , , | Leave a comment

Returning to the Moon: Viewport Glare Reduction

Continuing to mine advice by John Stevenson, I adapt his changing of banner images to have legible white-on-dark titles with no “white-out” glare.   The default banner (shown at Mapping Probe) also takes too much space.

File spanner/themes/landscape/source/css/images/banner.jpg  is the source for the banner image.  It is a 1920 by 1200 pixel image presented with 300 pixel height.  I cropped away the bottom, producing short-banner.jpg as a 1920 by 600 image of  starscape only.  Strangely, the only tool I had for accomplishing this change reliably is my screen-capture utility, HyperSnap 7.29, an unexpected bonus.

The short banner is the top half of the original banner image provided by the Hexo default theme, landscape

Theme processing will copy this image to spanner/public/css/images/short-banner.jpg.  Posts and pages will access it at the uploaded Spanner Wingnut css/images subfolder.

To use the new banner and size, the spanner/source/css/_variables.styl file is adjusted.

The theme source/css/ _variables.styl file banner change is by changing banner-height to 150px and banner-url to images/short-banner.jpg

This is sufficient to have a smaller banner with clear lettering.

The blog title "Spanner Wingnut's Muddleware Lab" and the subtitle are now clear with white type on a mostly-black background.

With this success, other adjustments come to mind, and they will be made in further adjustment of the banner, now that it is under control.

Posted in Blog Development, blogs, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , | Leave a comment

Returning to the Moon: Orbital Resupply Glitch

With achievement of Disqus commenting and connection of the About and other pages,  it is time to put the Hexo-generated pages as the default for Spanner Wingnut.

Throwing the switch involves copying the generated public/index.html page to public/default.htm so that the uploaded public/ material will be served as the default.  To avoid loss to the previously-generated Movable Type content, that is all backed-up and the last of those front pages is now at wingnut/default.mt4.htm.

The only problem is that added copy operation in my tidygen.bat script was not executing.  In fact, all of the script following the script’s hexo generate command is not executed.  That was an eyebrow-raiser before, and now I had to resolve it.

The Hexo command is itself implemented by a batch script, hexo.cmd.  CALL must be used in order to have exit from hexo.cmd to continue in the tidygen.bat script

I found where command hexo is located in the command-line search path and confirmed that it is implemented by a batch script.  hexo’s exit ended tidygen.bat also.  The remedy is to use the CALL batch command so that there is proper nesting and return.

And now, deployment will properly update the hosted-location of the Hexo-generated blog as the current implementation for Spanner Wingnut’s Muddleware Lab.

Posted in Blog Development, blogs, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , | Leave a comment

Returning to the Moon: Mapping Probe

With the Hexo static-page generation scheme, each page/post is in a (sub-) folder with its permalink name and an index.html file to be served as the page.  This allows other artifacts/assets to be in the same folder.  That’s handy for page-specific images and for other special content.  It works very well for how I prefer to organize web-site pages into what I refer to as individual folios.

Rethinking the Terrain

I successfully established a page/folder for “About” and also demonstrated that I could create sub-pages on the same style.  Rethinking, I refactored the about/ folder to be hexo-about/   and I qualified the sub-structure also.

The hexo-about folder carries its default index.html page , collateral files, and two subfolders concerning the hexo customization for spanner and the landscape theme customization

Renaming to hexo-about/ is a precaution in case this blog creation scheme is supplanted by yet-another.  I want the Hexo-generated blog preserved side-by-side, just as this one sits side-by-side with its Movable Type and Blogger predecessors.  The assets and substructure are for preserving artifacts and narrative about customizations in case I need to re-create them.  I have them under source-control, but I want them accessible on the Internet just-in-case.   This pattern applies to restoration of all nfoCentrale blogs for which Spanner Wingnut provides the pilot demonstration.

Updating the Maps

Although the about/ and now hexo-about/ pages are generated now,  “About” links on the front page and the archived posts are needed.  I continue relying on advice by John Stevenson, this time for adjusting the navigation bar.  It is the landscape theme _config.yml that is updated.

The menu caption and link are added to the annotated theme _config.yml by adding the item under the existing "menu" item.

In order to confirm the change and also perpetuate it to all content, a clean regeneration of the public content is performed.  Uploaded content demonstrates the changes.

Generated web pages now have the correct "About" link in the menu "navbar" at the top of page headings.

Here There Be Sea Serpents

It is tempting to “go live” and change the generation procedure to take over the Spanner Wingnut default page.  I’ll not do that just yet.  There are too many empty spaces remaining to be explored and mapped.

  • There are remaining changes that will require complete regeneration of all content as part of their implementation.  That makes going-live premature.  I want a place where only new pages need to be uploaded, since all thematic changes are in effect.
  • The additional changes are ones that I must perfect in order to be able to apply Hexo to the restoration of production blogs.  Restoring Numbering Peano is the benchmark. 

My TODO lists are managed in the narration of configuration materials and related files.

Comments at the end of the theme's _config.yml file provide TODO items  and customization version history notes.

I also don’t know how accessibility requirements are addressed.  It is exciting that the blog pages are now responsive and some of the features, such as the hook-in of Disqus, work beautifully out-of-the-box.  I seek more of that ease in adjustment of other features.

Posted in Blog Development, blogs, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , | Leave a comment

Returning to the Moon: Coms Chatter

I’m now seeking small changes that give me important improvements in the Hexo-generated revitalization of Spanner Wingnut’s Muddleware Lab, still in proof-of-concept position.  

Tracking down some great tips by John Stevenson, I am eager to confirm a one-liner configuration change to enable comments.

Adding the single line with disgus_shortname and the label assigned by Disqus is enough to cause generation of comment forms and information.

The addition is in the top-level _config.yml file in the spanner/ authoring folder initialized by Hexo.

After a clean generation, I found this great arrangement fully operational.  First, the bottom of the generated home/front page has a count of comments and a link. 

Scrolling down to the bottom of the blog front page (the latest post) provides a comment tally and a link to the permanent/archived page.

At the bottom of the persistent/archived page, the latest Disqus information will appear after a short spin.

The entire comment areas are generated on-the-fly by Disqus.  The stored web page is not actually touched.  There are different ways for commenters to authenticate themselves, and all visitors can observe the comment threads and related suggestions from Disqus

The provision of comment blocks also appears automatically on fixed pages, such as About and any others created in conjunction with the blog.

This is a great little-effort achievement using the Hexo-initialized authoring folder and the default theme.

Happy Dance.

Posted in Blog Development, blogs, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , | Leave a comment

Returning to the Moon: Project Inspection Report

Following some serious scrutiny and confusion over nomenclature, I managed to disentangle use of wingnut/ as the folder having the refactored blog creation and wingnut/ as the full authoring folder in which the blog is produced from just the public/ subfolder.

The solution is to use spanner/ for the complete, Hexo-supported authoring folder.   Now wingnut/ is used exclusively for the generated static pages produced in spanner/public/ and uploaded to the hosted-site blog folder.

While refactoring my various accounts to reflect the new division between development folder and the developed blog, I finally added a script, tidygen.bat, for cleaning up and then generating changed/new static blog material.

tidygen.bat produces a display of its cleanup operations and then the generation of pages having new/updated content.

I have adopted a common format used for other Windows batch scripts of mine.   The tidygen.bat file provides error checking and important checks on where it is being run before doing anything potentially destructive.   The script is now available for additional generation and deployment customization.

As part of restructuring, I am also using the blog’s About folder to carry auxiliary files providing a persistent public account of the work and its dependencies.  Some of these are mirrors of development files (such as tidygen.bat and NOTICE.txt) along with links to other web-published information.

Posted in Blog Development, blogs, Golden Geek, Spanner Wingnut, Toolcraft | Tagged , , , , | Leave a comment