Coder Social home page Coder Social logo

jj / hoborg Goto Github PK

View Code? Open in Web Editor NEW
191.0 45.0 82.0 2.52 MB

A dieselpunk novel with Spanish-created robot hobos in a balcanized America at the beginning of the XX century

License: Other

Perl 39.65% Shell 0.17% TeX 3.43% CSS 0.95% JavaScript 51.06% HTML 2.66% R 0.75% Raku 0.23% Dockerfile 1.11%
hacktoberfest hacktoberfest2023 literature

hoborg's Introduction

Manuel the Marvelous Mechanical Man, the novel

This is the source for an ur-dieselpunk novel with a Spanish-created robot hobo in a balkanized United States of America at the beginning of an alternative XXth century.

The novel is available in Amazon.com for a dollar.

Build status

For the time being, mainly related to typos:

Build Status

Plot outline

After the United States of America is defeated by a technologically superior Cuba and Spain, Florida becomes an independent multiracial socialist state which is immediately at war with the (now diminished) America.

A North-American Pinkerton agent is sent there to recover a mechanical man that has been seen in a circus doing gigs from Pensacola to St. Petersburg, entertaining the masses.

He succeeds, or not, but taking the loot back to Washington might not be so easy. He becomes a railway hobo, accompanied with a hobo cyborg - the hoborg of the title of this repo

How you can help

After the paragraphs above, you might have already realized English is not my main language. Sending me corrections is not the only way you can help

  • Get a GitHub account.
  • Watch, star or fork this repo. You don't need to do anything else. for the time being, but it will help me achieve some visibility.
  • You can interact with the text and the rest directly from the web: you can comment on text and changes in it (called commits).
  • You can also request changes on the text using issues. If you find an error of any kind, just raise an issue and I'll fix it (or try to).
  • Create your own version: once forked, you can use git (check out this manual http://wiki.freegeek.org/index.php/Git_for_dummies ) to branch and evolve the story in whichever way you want.
  • You can keep that copy (hey, it's free as in free speech) or, if you think it's a worthwhile addition to Hoborg, do a Pull Request.
  • Check out the TODO list in case you find something that you could do yourself.

Full disclosure

The novel is roughly completed (that is, while it's got an ending, it will actually never be finished since it might evolve in time) and is published in Amazon.com and the rest of the Amazon shops. Since all your contributions will be here, in the repo, they are obviously acknowledged, but I'll acknowledge it also in the prologue itself and, if I earn enough to be able to physically print it and mail it, will mail you a copy. That's quite unlikely to happen, however, so I'll make a promise I can keep: to follow you in Twitter, so accompany your pull request with your Twitter account so I can fulfill my promise.

Start reading and participating

Just go to the novel. You can also read about the characters, although doing so might result in spoiling the story for yourself, or about the geography of the Republic of Florida.

Thanks

Many thanks to those who have provided fixes and suggestions to the text: yarikoptic and quentessential.

How this can help you write your own novel

Read the installation instructions to get your very own novel going in Github. They are long-ish, but may be worth your while.

Navigating the repository

You already know the text directory, which contains the novel text itself as well as scraps we might need for later. resources contains HTML templates, images and other non-text stuff. apps includes conversion scripts and other mainly Perl scripts I use for managing this. Text-Hoborg contains a Perl module that is used for testing and continuous integration and might eventually contain the novel itself and be released that way.

Get in touch

If you have some issue related to the novel, use the GitHub issues. For any other business, just email me.

hoborg's People

Contributors

erseco avatar gitter-badger avatar haujason avatar jcolag avatar jj avatar mvdoc avatar quentessential avatar snastase avatar spiqueen14 avatar yarikoptic avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

hoborg's Issues

General cleanup

After 10 years, some things are no longer necessary, and some were not really
used. Difficult to list them all, but I'll simply leave this here to refer to it
when I do some housekeeping.

Revise the revisions

And produce a second edition, three years after. There are some revise marks here and there. Check them out, or at least delete them.

"America" => "Northern America" or better "USA"

Hi, I'm reading the plot:

"After America is defeated by a technologically superior Cuba and Spain, Florida becomes an independent multiracial socialist state which is inmediately at war with the (now diminished) America.

An American Pinkerton agent is sent into that state to recover a mechanical man that has been seen in a circus doing gigs from Pensacola to St. Pitersburg entertaining the masses.

He succeeds, but going back to Washington is not easy. He becomes a railway hobo, accompanied with a hobo cyborg - the hoborg of the title."

During these 13 years in Argentina, I have understood the importance of not calling the USA "America". America is also Canada, Mexico, and all the Central and Southern America states including Argentina extending almost to the South Pole.

No lecturing intended, just constructive contribution: I am Italian and while living in Italy and France I was, as anybody else there, calling "America" the USA.

Cheers!
Nicola

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.