An Annotated Version of Harry Potter and the Methods of Rationality
This is the source of the website hpmor.info which contains the text of Eliezer Yudkowsky's Harry Potter fanfiction Harry Potter and the Methods of Rationality with annotations explaining foreshadowing and other details. Many of the annotations are taken from comments in the /r/HPMOR subreddit.
Contributions of notes are welcome!
If you have a simple note to add, the easiest way is via an "issue". Open the issue using the "Note Proposal" template. Fill in the paragraph number and the text of the note. You can also add your name. Once you submit the issue, a bot will add the note to the yaml files and add a comment allowing to open a pull request. You can either open the pull request yourself or wait for me to do it.
If you wish to add several notes, or if you wish to add notes with formatting or based on reddit comments, it is better to directly edit the source files and open a pull request. A convenient way to contribute is to use the github.dev interface. Paragraphs on hpmor.info have a + link to their left, which opens a VS Code editor in your browser with the corresponding file open and the paragraph selected. You can then make your changes and open a pull request directly from the editor.
The notes are stored in yaml files in the yaml directory. Each chapter has its own file named <number>.yaml. The format is as follows:
131:
text: |-
"I don't sleep right," Harry said. He waved his hands helplessly. "My sleep
cycle is twenty-six hours long, I always go to sleep two hours later, every day.
I can't fall asleep any earlier than that, and then the next day I go to sleep
two hours later than <em>that.</em> 10PM, 12AM, 2AM, 4AM, until it goes around
the clock. Even if I try to wake up early, it makes no difference and I'm a
wreck that whole day. That's why I haven't been going to a normal school up
until now."
notes:
- type: original
date: 2020/04/30
author: hpmor.info
text: |
<p>
Harry's sleep cycle is 2 hours too long because Dumbledore slipped him a
potion in order to fulfil a prophecy.
<a class="link-hpmor" href="https://hpmor.info/chapter/119/#19126">Chapter 119</a>
</p>The date should refer to the date that the note was written, using an unusual format with slashes to work better with YAML format.
The author is optional; it is not currently displayed but may be in the future. If you would like credit for your contributions, feel free to put any of the following:
- Your name
- An
<a href="...">Your name</a>link to your website or social media profile - A URL to a github, reddit, or LessWrong profile
The text should use HTML, typically one or more <p>-wrapped paragraphs.
The example above contains a link to https://hpmor.info/chapter/119/#19126, which points to a specific paragraph (number 19126). You can find links to paragraphs on hpmor.info by checking the gray "anchor" links to the left of each paragraph. Use class="link-hpmor" for links to hpmor.info and class="link-reddit" for links to Reddit, and no class for links to other sites.
Note types. Normal notes should have - type: original. There are also - type: reddit notes which copies of Reddit comments. There is a little web tool for fetching a reddit comment and turning it into YAML format: https://hpmor.info/reddit-fetch/
Example of the YAML format for reddit notes:
1424:
text: |-
"Just kidding! RAVENCLAW!"
notes:
- type: reddit
author: EliezerYudkowsky
url: https://reddit.com/r/HPMOR/comments/4h2t8c/the_incident_with_the_sorting_hat_spoilers_all/d3312wg/
date: 2016/05/12
score: 8
text: |
<p>
It was either the Sorting Hat or Dumbledore. Professor Quirrell would have
left him in Slytherin, <em>of course</em>.
</p>It may be useful to support similar syntax for other types of notes in the future, such as LessWrong comments. Feel free to implement this if you want to, or open an issue if you want me to look into it.