Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

David MacKay's Sustainable Energy without the Hot Air: markdown-ed, integrated #5

Closed
14 tasks done
rufuspollock opened this issue Aug 17, 2021 · 1 comment
Closed
14 tasks done
Assignees

Comments

@rufuspollock
Copy link
Member

rufuspollock commented Aug 17, 2021

Integrate and make annotatable David MacKay's Sustainable Energy - Without the Hot Air (http://withouthotair.com).

Context

David MacKay's Sustainable Energy - Without the Hot Air (http://withouthotair.com) was a landmark text and still provides an incredible foundation for looking at energy policy and climate change.

However, the book was published in 2008. As David tragically passed away in 2016 the book did not get to updated and is now, as of 2020, becoming a little out of date. See this 2017 article on Carbon Commentary with concrete suggestions https://www.carboncommentary.com/blog/2017/3/30/l6qcqgoedse1wmjjz87t09usoq6jva and associated thread on ycombinator: https://news.ycombinator.com/item?id=14009057

We are therefore thinking of getting a source markdown version and published copy here for 3 reasons:

  • A local text we can integrate and reference
  • Collaborative updating of the text (as per above)
  • An updated web publication of the text: similarly to the previous point the existing web version of the text could benefit from a more up to date presentation.

Tasks

  • Decide whether to keep in separate repo or merge to climate repo Merge to climate repo as let's keep things simple
  • Identify source version of the book (e.g. epub or tex or html) DONE. Went for the epub. Tito Jankowski has a version here https://github.com/titojankowski/sustainable_energy_without_the_hot_air but its from html as not so great quality
  • Create sub-project in this repo for it
    • Archive raw source material
    • Create README etc
  • convert that to markdown See https://github.com/life-itself/climate/tree/main/sewtha
    • pandoc to get raw source See the extract.sh
    • clean that See the extract.sh
    • split into sections (or keep as one) Keep as one
  • Split into sections - this is needed I think DONE: 24 Aug. Started again with epub. See extract.py
  • home page for it e.g. at /without-hot-air/
    • remove first effort at /sewtha/ and add redirect
  • publish DONE: Live for now at https://climate.lifeitself.us/sewtha/README

Misc

Analysis

Sources

License

Original text is copyright Professor David JC MacKay FRS (Professor of Natural Philosophy, Department of Physics, University of Cambridge) and licensed under a Creative Commons Attribution-Non-Commercial-Share-Alike 2.0 UK: England & Wales Licence. See http://withouthotair.com/about.html

This is a free book. I didn't write this book to make money. I wrote it because sustainable energy is important. If you would like to have the book for free for your own use, please help yourself to any of the electronic versions on this website. There's pdf and html versions (thanks to William Sigmund!); we are working on other formats.

This is a free book in a second sense: you are free to use all the material in this book, except for the cartoons and the photos with a named photographer, under the Creative Commons Attribution-Non-Commercial-Share-Alike 2.0 UK: England & Wales Licence. (The cartoons and photos are excepted because the authors have generally given me permission only to include their work, not to share it under a Creative Commons license.) You are especially welcome to use my materials for educational purposes. This website includes links to separate high-quality files for each of the figures in the book.

Additions and modifications by other authors are dual-licensed under a Creative Commons Attribution License v4 (unported) and Creative Commons Attribution-Non-Commercial-Share-Alike 2.0 UK (as required by the Share-Alike license).

@rufuspollock rufuspollock self-assigned this Aug 17, 2021
@rufuspollock rufuspollock changed the title David McKay's Sustainable Energy without the Hot Air in editable form for updating David MacKay's Sustainable Energy without the Hot Air: markdown-ed Aug 17, 2021
@rufuspollock rufuspollock changed the title David MacKay's Sustainable Energy without the Hot Air: markdown-ed David MacKay's Sustainable Energy without the Hot Air: markdown-ed, integrated, annotatable Aug 17, 2021
rufuspollock added a commit that referenced this issue Aug 17, 2021
…y without the hot air.

In /sewtha/ directory. Working with the website.

* epub source
* extract.sh that does all the extraction and cleaning (quite a bit of debugging to make sure html is well-behaved for next/mdx)
* images for the text in site/public/img/sewtha (could be nicer to keep these with the text and copy over in build ...)
rufuspollock added a commit that referenced this issue Aug 24, 2021
…hapters e.g. now have /without-hot-air/chap01.

* extract via unzipping epub and then processing each html (not only needed for sections but cleaner markdown)
* redo processing script in python (vs bash)
  * not only cleaner but can have tests
* move to symlinking content from the without-hot-air folder into content and site folders
@rufuspollock rufuspollock changed the title David MacKay's Sustainable Energy without the Hot Air: markdown-ed, integrated, annotatable David MacKay's Sustainable Energy without the Hot Air: markdown-ed, integrated Sep 2, 2021
rufuspollock added a commit that referenced this issue Sep 2, 2021
rufuspollock added a commit that referenced this issue Sep 2, 2021
…a) and redirect to new chapter version at /without-hot-air/ with redirects.
@rufuspollock
Copy link
Member Author

rufuspollock commented Sep 2, 2021

FIXED. All done. Live at https://climate.lifeitself.us/without-hot-air/.

Follow up in #6 and #16 and #21

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant