Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
extratone committed May 15, 2021
1 parent 7e531c8 commit 8da1bdc
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 4 deletions.
28 changes: 25 additions & 3 deletions drafts/WFiOS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Writeas/WriteFreely iOS Publishing Workflow

![Editorial Git - Wood](https://i.snap.as/ocT2o2B3.png)

## Demonstrating the particulars of a version-tracked Markdown publishing process - including the full extent of parallel research, documentation, and web development - optimized for and entirely contained within iPhone (for the insane.)

[[Notes: Writeas/WriteFreely iOS Publishing Workflow]]

When _Extratone_ was running on WordPress, I found myself writing about it all the time, partially because I was learning how broken the web had become (largely thanks to WordPress,) but mostly because of all the drama surrounding the endeavor. There’s a lot to say about bad software, so writing about it is _easy_ - I understand this truth, intimately - but _The Psalms_’ number one mandate is to celebrate uniquely clever, undercovered solutions, and by golly, one has been staring both you and I in the face for years, now, without mention on this blog. This year’s dive into iOS has inadvertently lead to many unexpected avenues of exploration, but the one that has underpinned them all has been using my iPhone 12 Pro Max as (essentially) my _primary machine_ for all of it: research, notes, (astonishingly) working in public via Git, composition, publishing, and spreading it all around. Write.as - the SaaS implementation of WriteFreely - is not only _capable_ of supporting this workflow - in my extensive use, I have discovered a path for which it is _particularly optimized_, I think. As I have committed to stop taking the Write.as suite for granted and become a more actively productive member of its community, I’d say it is the perfect time (for once) to let loose and zoom _all the way in_.
Expand All @@ -17,9 +21,27 @@ The above apps are all that’s needed if your end goal is just publishing and e
There is a limit, but it feels completely absurd to define: you can’t actually _host_ a WriteFreely installation on your phone. That is to say - you can’t really use your cell phone as a fucking server… At the moment, anyway. Considering you _can_ run the Write.as command line client in a Linux shell and interact with the service via the Write.as API… on your phone… Who is to say, really, if running a persistent Linux server in the background will be possible on iPhone in the near future?[^1]

All that said, here are some apps enabling _mobile web development_:
* [**Working Copy**](https://apps.apple.com/us/app/working-copy-git-client/id896694807) is the Git client of choice on iOS. It is alarmingly capable and thoughtfully designed to wholly integrate Git into the OS so that it is not only _usable_ but (incredibly) _natural_ to use it. Pushing and committing a file with full annotation can be accomplished _from the share sheet_.
* [**Working Copy**](https://apps.apple.com/us/app/working-copy-git-client/id896694807) is the Git client of choice on iOS. It is alarmingly capable and thoughtfully designed to wholly integrate Git into the OS so that it is not only _usable_ but (incredibly) _natural_ to use it. Pushing and committing a file with full annotation can be accomplished _from the share sheet_.
* [**GitHub for iOS**](https://apps.apple.com/us/app/github/id1477376905) is still the best way to make use of the GitHub-specific, extra-Git features handled in this workflow (manipulating/commenting on Issues, mainly.)
* [**Kodex**](https://apps.apple.com/us/app/kodex/id1038574481) is my favorite code editor/IDE for directly editing files. It’s beautiful, free, and designed to make the best of the ridiculous undertaking that is code editing on iPhone.
* [**iSH Shell**](https://apps.apple.com/us/app/ish-shell/id1436902243) is a **full Linux shell on your fucking iPhone** with an incredibly helpful community. Realistically, it’s best for running little Command Line utilities like Pandoc, but it is also disturbingly capable of crazy scraping shit with wget and youtube-dl. Theoretically, old school Gitists who prefer to use it in the Command Line could do so in iSH, but [a-Shell](https://apps.apple.com/us/app/a-shell/id1473805438) (the popular alternative) might be more optimized for that, considering it functions as an actual Terminal within Files. (Sorry, I’m not quite crazy enough to try it.)
* For CSS color alterations, I’m concluding my recommendations with two Hex-based utilities: [Color Pro](https://apps.apple.com/us/app/color-pro-p3-picker/id1207928528) for precision color _picking_, and Pastel
* [**iSH Shell**](https://apps.apple.com/us/app/ish-shell/id1436902243) is a **full Linux shell on your fucking iPhone** with [an incredibly helpful community](https://discord.gg/iSH). Realistically, it’s best for running little Command Line utilities like [Pandoc](https://github.com/jgm/pandoc), but it is also disturbingly capable of crazy scraping shit with wget and youtube-dl. Theoretically, old school Gitists who prefer to use it in the Command Line could do so in iSH, but [a-Shell](https://apps.apple.com/us/app/a-shell/id1473805438) (the popular alternative) might be more optimized for that, considering it functions as an actual Terminal within Files. (Sorry, I’m not quite crazy enough to try it.)
* For CSS color alterations, I’m concluding my recommendations with two Hex-based utilities: [Color Pro](https://apps.apple.com/us/app/color-pro-p3-picker/id1207928528) for precision color _picking_, and [Pastel](![Drafts and Git on iOS](https://i.snap.as/3jFBoVzA.png)) for keeping track of them with “palettes.”

![Drafts and Git on iOS](https://i.snap.as/3jFBoVzA.png)

Before I go on, I must once again make a big effort to accredit the very same Federico Viticci: I began this guide thinking his original [Markdown + Working Copy x GitHub iPad Pro publishing workflow](https://www.macstories.net/ios/my-markdown-writing-and-collaboration-workflow-powered-by-working-copy-3-6-icloud-drive-and-github/) dated back to November 2018, but I clearly need to pay more mind to hyperlinks because it actually [_originated_ sometime in **_2016_**]((https://www.macstories.net/stories/one-year-of-ipad-pro/6/#content), which is… An entirely distinct kettle of fish.

> Each MacStories writer has their own private GitHub repository where they can save drafts of articles currently being worked on. Other members are invited to the repository so they can read each other’s stories and provide feedback. We have a general Club MacStories repository that John and I use to assemble issues of our newsletter every week, and I also have a personal repository where I save drafts I would like others to read in advance.
It was _very_ recently that I observed in my notes for “[Editorial Git](https://github.com/extratone/bilge/discussions/86)” that *The Psalms* might have been the longest-running implementation of Git in the “real world” writing process as opposed to the the mostly-demonstrative discourse from a microera around 2018-2019 when Markdown and Git were considered as the future of _academic_ publishing. As far as I can tell, the conversation was largely prompted (or substantially revived, at least) by WashU professor Ed Hagen in an essay/blog post entitled “[Should scientific publishing move to Github and friends?](https://grasshoppermouse.github.io/posts/2019-07-12-should-scientific-publishing-move-to-github-and-friends/),” which gathers a variety of references to projects exploring parallel avenues and comprehensively proposes a theoretical workflow. Since the more recent of the aforelinked Federico posts describes his use of the very same services (Working Copy and Github,) is freely available, impeccably well-considered, and beautiful to read, I’m going to proceed as if I have nothing original to contribute to that conversation (because I don’t.)

I’d ask that _you_ proceed with the knowledge that this guide is far from absolute - you can and _should_ pick and choose different components to form your own workflow - and that it is definitely not exclusive to Write.as/WriteFreely, considering our end output is markdown-formatted text. I have chosen to frame it around the .as suite because it (debatably) [saved my life](https://write.as/community/chat-with-david-blue) and I am therefore quite personally invested in the growth of its userbase and the health of its community. On that vein, I’ve recently [committed to starting the WriteFreely Community Discord Server](https://discuss.write.as/t/write-as-writefreely-community-discord/2831) and published [a new version of this blog’s theme](https://github.com/extratone/bilge/releases/tag/3.1) which I hope will prove useful to newcomers interested in customizing their Write.as/WriteFreely blogs.

I also want to make it clear that this guide was written as a exploration of what is technically possible on iOS/iPhone at the moment, _not_ what I’d consider actually _advisable_. While I myself have been playing around across the spectrum of tools listed here on my 12 Pro Max - including drafting all of this guide, itself, as well as the vast majority of my [iPhone × Music overview](https://bilge.world/iphone-ios-music-apps) - I can’t say I expect to continue using my cellular phone in this way except for any special away-from-desktop circumstances.

## Composing
I’m starting out of order because I feel it’s impor



[^1]: I decided _not_ to explore whether or not the jailbreak community has addressed this.
20 changes: 19 additions & 1 deletion notes/WFiOSNotes.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

[[Writeas/WriteFreely iOS Publishing Workflow]]

* [**Bilge Theme Version 3.1**](https://github.com/extratone/bilge/releases/tag/3.1)
* [Writeas/Writefreely Tips](https://github.com/extratone/bilge/issues/28) #28
* [My response to the thread about publishing via email](https://discuss.write.as/t/add-pictures-to-email-publishing/2777/3)
* [WriteFreely for iOS on the App Store](https://apps.apple.com/us/app/writefreely/id1531530896)
Expand All @@ -13,9 +14,26 @@
* [a-Shell on the App Store](https://apps.apple.com/us/app/a-shell/id1473805438)
* [Color Pro on the App Store](https://apps.apple.com/us/app/color-pro-p3-picker/id1207928528)
* [Pastel on the App Store](https://apps.apple.com/us/app/pastel/id413897608)
* [GitHub on the App Store](https://apps.apple.com/us/app/github/id1477376905)

### Hardware
1. [iPhone 12 Pro Max - 256GB, Pacific Blue](https://store.apple.com/xc/product/MGCN3LL/A). (`MGCN3LL/A`)
2. [Magic Keyboard with Numeric Keypad - US English - Space Gray\](https://store.apple.com/xc/product/MRMH2LL/A)
3. [Tylt Crest Convertible 3 Coil Wireless Charger](https://www.att.com/buy/accessories/chargers/tylt-crest-convertible-3-coil-wireless-charger-white.html)

## References
* [A Computer for Everything: One Year of iPad Pro - MacStories - Part 7](https://www.macstories.net/stories/one-year-of-ipad-pro/7/#github-and-markdown-editing)
* [My Markdown Writing and Collaboration Workflow, Powered by Working Copy 3.6, iCloud Drive, and GitHub - MacStories](https://www.macstories.net/ios/my-markdown-writing-and-collaboration-workflow-powered-by-working-copy-3-6-icloud-drive-and-github/)
* [Command-Line — Write.as Apps](https://write.as/apps/cli)
* [How to Run a Simple Web Server on iPad or iPhone | OSXDaily](https://osxdaily.com/2019/02/20/run-simple-web-server-ios-ish/
*

## Resources
* [iTextEditors - iPhone and iPad text/code editors and writing tools compared](https://brettterpstra.com/ios-text-editors/)
* [writeas/go-writeas: Go client for the Write.as API](https://github.com/writeas/go-writeas)
* [writeas/go-writeas: Go client for the Write.as API](https://github.com/writeas/go-writeas)

### Drafts
* [Embed <audio> Element | Drafts Directory](https://actions.getdrafts.com/a/1lM)
* [The Psalms | Drafts Directory](https://actions.getdrafts.com/t/1km)
* [Windows Iowa | Drafts Directory](https://actions.getdrafts.com/t/1kY)
* [RoutineHub • Capture Web Page to Drafts](https://routinehub.co/shortcut/8994/)

0 comments on commit 8da1bdc

Please sign in to comment.