Update Home

Home.md

@@ -1,56 +1,56 @@
 # How to write for MetamorPOV
 
-When supported by the author, this system allows for readers with the browser extension installed to heavily customize reader-insert stories. In addition to replacing `Y/n` with the reader's name, this system can also replace pronoun and perspective hooks provided by the author with the reader's choice.
+You already have all of the know-how that you need to write with MetamorPOV! We know that "her likes crocodiles" is wrong. It *feels* wrong, even if we can't put a finger on exactly where it went wrong immediately. When writing in plain English, we unconsciously validate the sentence structure. The greatest difference when writing in MetamorPOV is that we need to consciously validate the sentence structure by understanding the elements of that structure.
 
-## Replacing pronouns
+In the example of "her likes crocodiles," "her" is an **objective pronoun**. Objective pronouns are used to refer to what a verb is acting on. This pronoun doesn't make sense for that phrase because the object of the verb in this case is "crocodiles." "Her" should instead be replaced by the **subjective pronoun** "she." The right phrase would be "she likes crocodiles."
 
-This process needs to be done by the author of a story because it requires contextual awareness that can't be machine-automated. Using the list below, replace any pronouns that refer to your reader character.
+## Pronoun scopes
 
-- `prn/s` is for subjective pronouns, such as he, she, and they
-- `prn/o` is for objective pronouns, such as him, her, and them
-- `prn/p` is for possessive pronouns, such as his, her, and their
-- `prn/a` is for possessive adjectives, such as his, hers, and theirs
-- `prn/r` is for reflexive pronouns, such as himself, herself, and themself
-- `prn/H` is for honorific abbreviations, such as Mr., Ms., Mx., and Dr.
-- `prn/h` is for honorifics, such as mister, miss, mix, and doctor
-- `prn/N` is for adult nouns, such as man, woman, and person
-- `prn/n` is for youth nouns, such as boy, girl, and kid
-- `prn/F` is for parents (adult family), such as father, mother, parent
-- `prn/f` is for children (youth family), such as son, daughter, child
-- `prn/k` is for siblings (kin), such as brother, sister, sibling
-- `prn/m` is for married partners, such as husband, wife, and spouse
-- `prn/d` is for dating partners such as boyfriend, girlfriend, and partner
+MetamorPOV defines three scopes for different uses: `pov/` scope, `plv/` scope, and `prn/` scope. Each scope implements five standard pronoun forms, two of which we've already reviewed!
 
-Note that these are case-sensitive! If written beginning with a capital letter, the replacement will be capitalized. As an example, `prn/s` would become "he" and `Prn/s` would become "He" if the reader had their pronouns set that way.
+- `pov/s` is for subjective pronouns (I, you, and he)
+- `pov/o` is for objective pronouns (me, you, and him)
+- `pov/p` is for possessive pronouns (my, your, and his)
+- `pov/a` is for possessive adjectives (mine, yours, and his)
+- `pov/r` is for reflexive pronouns (myself, yourself, and himself)
 
-It may seem like a lot, but many stories only use the first three types of pronouns! I recommend proofreading with different configurations to make sure your stories are adapted correctly. Although `prn/o` and `prn/p` are both "her" for readers using a female pronoun set, they may be different for users with other pronoun sets.
+The first scope, `pov/` is used for narration. In third-person, `pov/` and `prn/` are identical, but not in other points of view! To revisit the example phrase, "pov/s likes crocodiles" will become "he likes crocodiles" is the reader is using he/him pronouns or "she likes crocodiles" if they're using she/her pronouns.
 
-## Replacing perspective
+`plv/` scope is for plural point-of-view. Use this scope instead of `pov/` if your narrator is acting as part of a group. "We" and "us" are examples of what this scope will become..
 
-Like with replacing pronouns, this process requires contextual awareness that can't be machine-automated. If not used, reader configurations for point of view will be ignored.
+`prn/` scope is for personal pronouns. Use this scope instead of `pov/` when a character other than the reader-insert is referring to them. These markers will always be in third-person! IIn addition to the five standard pronoun forms, this scope includes some exclusive gendered nouns that can be configured by the reader.
 
-- `pov/s` is for subjective pronouns: I, you, and he
-- `pov/o` is for objective pronouns: me, you, and him
-- `pov/p` is for possessive pronouns: my, your, and his
-- `pov/a` is for possessive adjectives: mine, yours, and his
-- `pov/r` is for reflexive pronouns: myself, yourself, and himself
-
-Plural perspective pronouns are also provided. These can get confusing in second-person because of their similarity to singular, so you may want to add exceptions when writing these.
-
-- `plv/s` is for plural subjective pronouns: we, you, and they
-- `plv/o` is for plural objective pronouns: us, you, and them
-- `plv/p` is for plural possessive pronouns: our, your, and their
-- `plv/a` is for plural possessive adjectives: ours, yours, and theirs
-- `plv/r` is for plural reflexive pronouns: ourselves, yourselves, and themselves
-
-`pov/S` and `pov/O` (note the capitals!) are the same as the lowercase versions except that they use `Y/n` in third-person. `pov/P` and `pov/A` are similar, using `Y/n`'s in third-person.
-
-Use `pov/` replacements when narrating, but `prn/` when another character is referring to the reader insert. As with replacing pronouns, I recommend proofreading different configurations! POV can flow weird when made adaptive, especially in third-person where the perspective pronouns can be read as belonging to non-reader characters.
+- `prn/H` is for honorific abbreviations (Mr., Ms., Mx.)
+- `prn/h` is for honorifics (mister, miss, mix)
+- `prn/N` is for adult nouns (man, woman, and person)
+- `prn/n` is for youth nouns (boy, girl, and kid)
+- `prn/F` is for parent nouns (father, mother, parent) and can be remembered as "adult family"
+- `prn/f` is for child nouns (son, daughter, child) and can be remembered as "youth family"
+- `prn/k` is for sibling nouns (brother, sister, sibling) and can be remembered as "kin"
+- `prn/m` is for married partner nouns (husband, wife, and spouse)
+- `prn/d` is for dating partner nouns (boyfriend, girlfriend, and partner)
 
 ## Replacing verbs
 
-Some verbs need to be conjugated differently between actors. Verb exceptions are formatted as `vrb/`verb (first-person, present tense)`/`tense`/`. Plural verbs always conjugate the same and don't need to be replaced.
+Not all sentences ("pov/s likes crocodiles" being an example) will work from all perspectives without also writing the verb in MetamorPOV syntax. Using "pov/s likes crocodiles," both "I likes crocodiles" and "they likes crocodiles" are wrong.
 
-- `vrb/has/present/` becomes "has" or "have"
-- `vrb/be/present/` becomes "is" or "are"
-- `vrb/be/past/` becomes "was" or "were"
+- `vrb/`infinitive verb`/` (assumes past tense)
+- `vrb/`infinitive verb`/`tense`/`
+
+If "pov/s likes crocodiles" is instead changed to "pov/s vrb/like/present/ crocodiles," it will conjugate to "he likes crocodiles" or "they like crocodiles" adaptively.
+
+**Important:** Use `vrn/` scope instead of `vrb/` scope when the subject is in `prn/` scope, as opposed to `pov/` scope!
+
+## Case sensitivity and names
+
+The first letter of every marker influences whether the result will be capitalized. "Pov/p" will always become "My" where "pov/p" will become "my."  Capitals at the end of a `pov/` marker will have another effect: in third person, these markers will become the reader's name. As an example, "pov/S vrB/like/present/ crocodiles" will become (for me, at least) "Jean likes crocodiles."
+
+**Important:** When using a capital at the end of a `pov/` marker, be sure to match the capital of the associated verb! If not marked, readers with their options set to third-person with plural personal pronouns will see "Jean like crocodiles" instead!
+
+If you want to use the reader's name in `prn/` scope, you can use `Y/n`!
+
+## Additional features
+
+- `cut/`phrase`/`amount`/` allows you to cut off a variable phrase. "Pov/s vrb/like/present/ cut/crocodiles/-6/" will become "I like croc," with the last six letters of "crocodiles" getting cut off.
+- `exc/`phrase`/`third-person alternate`/` allows you to differ content by point-of-view. "exc/Pov/s vrb/like/present/ crocodiles/Pov/s vrb/love/present/ crocodiles/" will become "I like crocodiles" in first-person, "You like crocodiles" in second-person, and "They love crocodiles" in third-person.
+- Readers can add their own replacements! If you want to write with a custom marker not provided by MetamorPOV, you have the option of suggesting that your readers add it to their configuration. Examples of replacements that may be useful but are not provided by MetamorPOV include last names, nicknames, and nobility titles.