diff --git a/README.md b/README.md new file mode 100644 index 00000000..da3ea175 --- /dev/null +++ b/README.md @@ -0,0 +1,466 @@ +[![Unicode Banner](https://i.snap.as/5fdq4LxC.png)](https://bilge.world/about) + +# *The Psalms* Editorial Documentation + +{:toc} + +{% note %} + +**Note:*- **THE TECHNICAL DOCS HAVE MOVED*- For the sake of my own sanity, all technical documentation regarding Write.as/WriteFreely has been moved to [**a dedicated repository**](https://github.com/extratone/writeas). + +{% endnote %} + +## This repository encompasses the whole of both the editorial and developmental processes involved in creating [bilge.world](https://bilge.world). + +See [**my 2020 reflectory post**](https://bilge.world/2020) for a few more details. + +[![Psalms Project Board](https://github.com/extratone/bilge/raw/main/images/Project%20Board.png)](https://github.com/users/extratone/projects/10) + +## Git + +- As part of [my continued exploration of Git as an editorial tool](https://github.com/extratone/bilge/discussions/86), I have done my best to make use of as many GitHub-specific features as possible. + +- [***The Psalms'* Project Board**](https://github.com/extratone/bilge/projects/1) tracks ideas, notetaking, research, documentation, drafting, revision, and extra-site discourse (like Tweets or *HackerNews* comments.) Its left-most column also documents style and technical changes to its code. +- I've been using [**Issues**](https://github.com/extratone/bilge/issues) to document just about anything, including all of the above, as well as any other specific subject involved (ex: [an "official" wallpaper pack](https://github.com/extratone/bilge/issues/97).) +- [**Commits**](https://github.com/extratone/bilge/commits/main) function as a chronological revision-tracker which I have indeed made use of in a few, particularly dire writing situations. +- I've been slow at integrating the [**Wiki**](https://github.com/extratone/bilge/wiki), but its uses - such as documenting [specific editorial definitions](https://github.com/extratone/bilge/wiki/%22Undercovered%22) - will continue to be expanded. +- [**Discussions**](https://github.com/extratone/bilge/discussions) are an intriguing possibility for external feedback (stop by and say something! really!,) but explaining why my general audience should have a GitHub account to participate even if they have zero interest in *dev* shit is going to be difficult. +- Within the code, you'll find my [**voice notes**](https://github.com/extratone/bilge/tree/main/audio/Voice%20Notes), an [**image library**](https://github.com/extratone/bilge/tree/main/images), and a variety of other miscellaneous associated files (better organization [is coming](https://github.com/extratone/bilge/milestone/1).) + +![Cute Git](https://user-images.githubusercontent.com/43663476/117531764-d6064100-afa9-11eb-9e09-783e189abe8e.gif) + +*** + +## [About](https://bilge.world/about) + +*This section is currently [a work-in-progress](https://github.com/extratone/bilge/issues/96).* + +[*The Psalms*](https://bilge.world) (alternatively/interchangeably entitled *Bilge*) is a monobyline World Wide Web Blog written by David Blue (good morning!) observing and selectively amplifying the characters, organizations, and stories surrounding the most abrupt, profound, and spectacular communicative renaissance in the history of the human species. + +Less abstractly, its beat is **wholly digital**, namely in **tools** (software, services, and methodologies) and **culture** (music, film, podcasts, and media) from a distinct lens established at good distance from California. + +It is entirely [written in public](https://tomcritchlow.com/2020/07/23/thinking-in-public/) largely via [**this GitHub Repository**](https://github.com/extratone/bilge), supplemented by experiments on a variety of [other platforms](https://www.notion.so/rotund/9fdc8e9610b34b8f991ebc148b760055?v=c170b58650c04fbdb7adc551a73d16a7), including (arguably) [my Twitter account](https://twitter.com/NeoYokel). + +## Contact + +**David Blue** + +- [Contact Card](https://davidblue.wtf/db.vcf) +- [Telegram](https://t.me/extratone) +- [Email](mailto:davidblue@extratone.com) +- [Twitter](https://twitter.com/NeoYokel) +- [Mastodon](https://mastodon.social/@DavidBlue) +- [Discord](https://discord.gg/0b9KQUKP858b0iZF) +- [*Everywhere*](https://raindrop.io/davidblue/social-directory-21059174)... + +*** + +# Technical Documentation (Writeas Blog) + +## Documentation for my blog, [bilge.world](https://bilge.world). + +I proudly use [Write.as](https://write.as) as my blog's CMS. I am relatively new to Git and GitHub, but it occurred to me that a repository would be a great place to track technical changes and even versions/revisions of drafts. + +*** + +[![Writeas Customization](https://i.snap.as/xpwZqmy4.png)](https://guides.write.as/customizing/) + + +## Installation (Bilge Theme) + +To "install" my theme on your own Writeas blog, copy and paste the contents of [Custom CSS.css](https://github.com/extratone/bilge/blob/main/Custom%20CSS.css) and [Custom Javascript.js](https://github.com/extratone/bilge/blob/main/Custom%20Javascript.js) into the respective "Custom CSS" and "Custom Javascript" fields in your blog's customization menu. + +See: "[Customizing Writeas](https://guides.write.as/customizing/)" + +*** + +![Bilge Three Point Oh Footer](https://i.snap.as/B3D5JvZ4.png) + +## [Colophon](https://bilge.world/colophon) + +*The Psalms* is proudly hosted by [Write.as](http://write.as/about) - a new sort of blogging content management system built atop [Markdown](https://daringfireball.net/projects/markdown/) and maintained by a company which [explicitly shares](https://write.as/principles) my commitment to a better, Open web. + +A somewhat-outdated version of this site's theme is [listed among others](https://write.as/themes/bilge) in Writeas' official themes list. The full, up-to-date CSS and JS can be found below and on in [this GitHub repository](https://github.com/extratone/bilge), which I created in November, 2020 as an experiment in using Git to track editorial changes. (*That means you can see [current in-progress drafts](https://github.com/extratone/bilge/tree/main/Drafts)!*) + +- ~~Download the entirety of this blog in EPUB format **[here](http://bilge.world/.epub)**~~. +- Subscribe to this blog's RSS feed **[here](https://bilge.world/feed/)**. +- This blog is federated at **@b@bilge.world**. + +### Typography + +**Body Text**: [Adobe Caslon Pro](https://fonts.adobe.com/fonts/adobe-caslon) + +**Nav/Headers/Other**: [Proxima Nova](https://fonts.adobe.com/fonts/proxima-nova) & Variations + +### Colors + +![The Psalms Colors](https://i.snap.as/yREEslm5.png) + +- [Expired Sour Cream](https://colornames.org/color/fff4e6) #fff4e6 +- [David Blue](https://colornames.org/color/00006b) #00006b +- [Red](https://colornames.org/color/ff0000) #ff0000 +- [Alarmed Suburbanite](https://colornames.org/color/f43f32) #f43f32 + +### [CSS](https://github.com/extratone/bilge/blob/main/Custom%20CSS.css) + +```css +@import url('https://use.typekit.net/kst2rrh.css'); + +body { + font-family: adobe-caslon-pro, serif !important; + font-weight: 400; + font-style: normal; + background-color: #FFF4E6; +} + +/* old background-color: #f2f2f2 */ + +#blog-title a { + font-family: proxima-nova-condensed, sans-serif; + font-weight: 900; + font-style: normal; + /* font-style:bold !important; */ + color: #00006b; +} + +header nav a { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 900; + font-size: 1.2em; +} + +header p.description { + /* font-style: italic; */ + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 700; + line-height: 200% !important; + color: #00006b !important; + font-size: 1em; + margin-left: inherit; + margin-right: inherit; +} + +body#collection header { + margin-bottom: 1em !important; +} + + +header nav a { + color: #00006b; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 900; + /* margin-bottom: 1em; */ +} + +body, +article { + font-family: adobe-caslon-pro, serif !important; + font-weight: 400; + line-height: 155%; + font-size: 1.1em !important; + color: #000000; + padding-left: 0.5rem; + padding-right: 0.5rem; + /* margin-top:1rem !important; */ +} + + +body, +article a:link { + color: #00006b; +} + +body, +article a:visited { + color: #FF0000; +} + +h1 { + color: #00006b !important; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 900; + font-size: 2em !important; +} + +h2 { + color: #00006b !important; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 700; + font-size: 1.4em !important; +} + +h3 { + color: #1c0021 !important; + font-family: proxima-nova-extra-condensed, sans-serif; + font-weight: 600; + font-size: 1.3em !important; +} + +h4 { + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-size: 1em !important; +} + +h5 { + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-size: 1em !important; +} + +h6 { + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-size: .85em !important; +} + +code { + /* background-color:#f7ff85 !important; */ + /* border: 1px solid #da2573 !important; + border-radius: 1px !important; */ + font-size: 0.85em !important; + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 400; + /* padding: 0px 0px 0px 0px !important; */ +} + +body #post pre, body#collection pre, body#post pre, body#subpage pre { + background: #FFFdeb; !important; + border: 1px solid #da2573 !important; + border-radius: 1px !important; + font-size: 0.85em !important; + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 400; + /* padding: 0px 0px 0px 0px !important; */ +} + +.post-title a:visited, +.post-title a:link { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 900; + color: #00006b !important; + font-size: 1.7rem !important; +} + +body#post article time.dt-published, +body#subpage article time.dt-published { + font-family: proxima-nova-condensed, sans-serif !important; + color: #00006b !important; + font-size: 1rem !important; +} + +body footer nav { + font-family: proxima-nova-condensed, sans-serif !important; + color: #00006b; +} + +blockquote { + font-family: proxima-nova-condensed, sans-serif; + font-weight: 400; + color: #333333 !important; + border-left: 2.5px solid #00006b !important; +} + +table { + background-color: #FFFdeb !important; + font-size: 0.8em !important; + line-height: 1.2em; + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 400; + border: 1px solid #f43f32 !important; + border-radius: 1px !important; +} + +article table td, article table th { + border: 1px solid !important; + border-color: #da2573 !important; +} + + +.gist { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 400 !important; + font-size: 18px !important; +} + +.gist .gist-meta { + font-family: proxima-nova-extra-condensed, sans-serif !important; + font-weight: 600 !important; + color: #1c0021 !important; +} + +.gist, .gist article, .gist article p { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 400 !important; +} + + +.gist .gist-file .gist-data { + background: #FFFdeb; !important; + border: 1px solid #da2573 !important; + border-radius: 1px !important; + font-size: 0.85em !important; + color: #1c0021 !important; + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 400; +} + +.gist, .gist article, .gist article p { + white-space: normal !important; +} + +/* .gist .gist-hr { + display: hide !important; +} */ + +hr { + border: 2px solid red; +} + + +body footer a.home:link, +body footer a.home:visited { + color: #00006b; +} + +.action { + font-family: proxima-nova-condensed, sans-serif; +} + +nav#manage ul a { + color: #00006b; +} + +nav#paging a { + color: #00006b !important; + font-family: proxima-nova-condensed, sans-serif !important; +} + + +a.bt { + background-color: #0d0d0d !important; + color: #00006b !important; +} + +a.hashtag { + font-family: proxima-nova-condensed, sans-serif; + font-weight: 700; + color: #00006b !important; +} + +body#collection #wrapper time, +body#subpage #wrapper time, +body#post article time.dt-published, +body#subpage article time.dt-published { + font-family: proxima-nova-condensed, sans-serif; + font-weight: 700; + font-size: 0.95em; + color: #00006b !important; +} + + +.custom-nav { + text-align: center; + font-size: 0.85em; + text-transform: uppercase; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 700; + color: red; +} + +.custom-nav a:link, +.custom-nav a:visited, +.custom-nav a:hover, +.custom-nav a:active { + color: #00006b; +} + +.custom-nav a:hover, +.custom-nav a:active { + text-decoration: underline; +} + +#subscribe-btn { + border: 1px #FF0000; + background: #00006b; + font-family: proxima-nova-condensed, sans-serif; + font-weight: 700; + font-size: 1em; + color: #FFF4E6; +} + +#emailsub { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 700; +} + +.footnote, .footnote-ref { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 700; + /* margin-left:2.5px; */ + color: #da2573 !important; + font-size: 1.1em; + text-decoration:underline #FF0000; +} + +.footnote-ref { + margin-left:25px; +} + +.footnote-ref-text { + font-family: proxima-nova-condensed, sans-serif !important; + font-weight: 400; + color: #1c0021 !important; + font-size: 1em; + border-top: #00006b dotted 1px; +} +``` +### [Javascript](https://github.com/extratone/bilge/blob/main/Custom%20Javascript.js) + +```javascript +var topP = document.createElement("p"); +//topP.style.textAlign = "center"; +topP.innerHTML = '
MastodonTwitterDiscordGitHubLicense
'; +var cont = document.getElementById("wrapper"); +if (cont !== null) { + // Add to blog index and tag pages + cont.appendChild(topP); +} else { + // Add to individual blog post page + cont = document.getElementById("post-body"); + cont.insertAdjacentHTML("afterend", topP.outerHTML); +} + +// src: https://platform.twitter.com/widgets.js + +// src: https://hypothes.is/embed.js + +window.hypothesisConfig = function () { + return { + "openSidebar": false, + "theme": "clean", + branding: { + appBackgroundColor: '#e6f7ff', + ctaBackgroundColor: '#da2573', + ctaTextColor: '#00006b', + selectionFontFamily: 'Georgia, serif' + } + }; +}; + +// Footnote hyperlinks in the body. +var notePattern = /\[\^(\d+)\]/g; +var noteText = "$1"; + +// Footnote references at the bottom. +var refPattern = /\[(\d+)\](.*)/g; +var refText = "$1$2"; + +var postContent = document.getElementById("post-body").innerHTML; +postContent = postContent.replace(notePattern, noteText); +postContent = postContent.replace(refPattern, refText); +document.getElementById("post-body").innerHTML = postContent; +```