Book Editing Guidelines

If you are looking for guidelines on editing character pages, click here.

The following serves as general guidelines on how to format Book pages correctly. We all want to be the best editors we can be and we all want this wiki to grow; so when you are editing, please make sure you're formatting pages correctly. These aren't necessarily rules that you must follow to the letter; they are more along the lines of guidelines to make sure things run smoothly and look uniform.

Below are some tips to help you when editing.

Under Construction Template

• If you are editing a popular page and want to avoid edit conflicts (that can happen when two or more users try to edit the same page at the same time), feel free to use the {{UnderCon}} template at the top of the page. This will show others that the page is currently being worked on and ask them to refrain from editing until you are finished.

  

  • Continuously ignoring the {{UnderCon}} template that other users have put up will result in a potential block ranging from at least 1-2 weeks or more depending on the user and the situation. If you look to the right, you can see a screenshot of the {{UnderCon}} template at work.
  • Mobile users should additionally check the page to be edited in desktop version as sometimes a template may temporarily not show in mobile version.

Creating A Book Page

When creating a brand new page for a book, there are 7-9 things that need to be considered. They are:

• the infobox
• the introduction (to the left of the infobox or underneath it)
• the summary
• chapters
• gameplay features (optional)
• gallery
• spoilers (optional)
• trivia
• references

Tip: When creating a new Book page, it is always wise to have another browser tab/window open with an established Book page. That way you can toggle between the two to compare and determine what you need and what is missing from the page you are creating.

Infobox

For book infoboxes, we use the "Book" template.

The infobox is fairly easy to use. The only fields you will need to edit are the values and the information next to the labels on the infobox. It is recommended for not-so-experienced users to edit in VisualEditor if you are not familiar or comfortable with wiki coding.

We do not put the book end date until the actual day that it occurs. We understand that Pixelberry will announce it on social media but until the day comes, we leave the date blank. This is to prevent errors in case Pixelberry is early or late on the book drop.

Tips

• 1. When editing infoboxes, it is best to leave an area blank if you are not sure about the information you have. For example, if an editor thinks that "The Royal Romance, Book 3" debuted on January 14, 2018 but wasn't sure, the user could ask an admin or find evidence to support the fact.
• 2. Remember to keep in mind that the first chapter of every book is free. When you update the key cost, please take that into account.
• 3. When indicating how many keys are needed for a book, keep in mind that the infinity key icon () is used for VIP Exclusive books only.

Introductory Paragraphs

Introductory paragraphs are the paragraphs you see at the top left of the infobox (desktop version) or underneath it (mobile version). They follow a very simple format and again, it is advised that not-so-experienced users use VisualEditor.

Below is the structure of an introductory paragraph for a book of a confirmed series:

Book name and number (in bold), is the (#) book of the (series name in italics, with a link to the category page) series. It succeeds its first two books, (book name in italics) and (book name in italics).

The word "the" in front of a series name is only omitted if the series name itself starts with "The". An example of this is:

The Royal Romance, Book 3 is the third book of The Royal Romance series. It succeeds its first two books, The Royal Romance, Book 1 and The Royal Romance, Book 2.

For upcoming books that are the first of their series but don't have a sequel confirmed yet, the structure is:

Name (in bold) is an upcoming book to Choices. It is the first and thus far only book of the (series name in italics, with a link to the category page) series.

Terror Fest is an upcoming book to Choices. It is the first and thus far only book of the Terror Fest series.

Once the book is no longer upcoming but ongoing but still has no sequel confirmed, the structure changes to:

Name (in bold) is the first and thus far only book of the (series name in italics, with a link to the category page) series.

The Ghost of Us is the first and thus far only book of The Ghost of Us series.

For standalone books, the words "thus far" are removed, resulting in the following structure:

Name (in bold) is the first and only book of the (series name in italics) series.

An example of this is:

Veil of Secrets is the first and only book of the Veil of Secrets series.

Tips:

• Remember to link the series name to its corresponding category.
• When assigning a book a year of release category, go by its first chapter release date. If a books wide release year differs from VIP release, it may be assigned both years. Said category may only be added once the Upcoming Books category is removed.

Summary

The summary of the book tells the reader what the book is going to be about and is used to draw them to the book. In most cases, Pixelberry will release a summary either on the various app stores or Twitter or the Choices App itself. The summary should be copied word for word and be written in italics.

Tip:

• If Pixelberry does not release a summary, the synopsis for the first chapter is normally used.

Chapters

The chapters listing of the book is similar to a Tables of Content for the book. It contains the each chapter title and its synopsis. Chapter names and numbers should be in bold, while the synopsis of the chapter should be in block-quote format. An example of the coding is shown below:

=== '''Chapter 1: Missing Persons:''' ===
<blockquote>Your best friend from college has invited you to her wedding! But in the town of Birchport, everyone has a secret...</blockquote>

Which shows as:

Chapter 1: Missing Persons: Your best friend from college has invited you to her wedding! But in the town of Birchport, everyone has a secret...

Gameplay Features

If a book has at least one unique gameplay feature, this section can be added. Examples for this are nerve system in the It Lives series and collections in various series. Each gameplay feature gets a new section with the following code:

===<u>(name of gameplay feature)</u>===

For example:

Skill System

If the gameplay feature has a page of its own, the link to it is provided in the heading:

===<u>[[Blades of Light and Shadow, Book 1 Collectibles|Collectibles]]</u>===

Collectibles

If there's an in-game tutorial, please add the description in the section. Otherwise briefly explain how the feature works. If there are several versions of gameplay features, you can make further (sub)headings. Here's the full example as seen on Blades of Light and Shadow, Book 1:

Gameplay Features Skill System Skills will help you conquer challenges, befriend allies, and unlock special scenes. More skills can be unlocked by earning XP which you'll get by making correct choices, defeating enemies, and passing Skill checks. Some choices will require you to have a Skill to choose them. These unlock special scenes and often award XP. Collectibles Lore Tablets: Collect them to learn more about the world, its inhabitants, and the history of the Great War. Collecting all six tablets will unlock a bonus scene. Legendary Weapons: Collect all the legendary weapons to enhance your fighting skills and earn bonus XP.

If you are unsure if the gameplay you want to add qualifies, please ask an admin, mod or regular editor.

Gallery

Galleries are the fun part. They can brighten up the mood of an article and can make a page popular. When creating galleries, there are a few things to note:

• Be aware that we do not add values like widths or other customization options to the gallery tag.

With books, galleries should be split up into four sections:

• Sneak Peeks
  • This is reserved for sneak peeks released by Pixelberry on various social media platforms.
• Pre-Book Sneak Peeks & Information
  • This section should contain anything that Pixelberry has released regarding the book and prior to the book's arrival, whether it be sneak peeks of the characters or parts of the story. They should also contain information released by Pixelberry about the book.
• Featured Location(s)
  • Locations that have their own wiki page are listed first with a link to the respective pages, in chronological order and separated by bullet points.
  • In the case where a location is part of another location (for example Edenbrook which is located in Boston), it is currently okay to either add both or just one of them.
  • If a location has a wiki page, images from these locations are only added in the gallery of the respective location page and not to the book page. Exceptions are dreams and other scenarios such as simulations where the background doesn't reflect the actual location (for example, the backgrounds of the different simulations Bookish Sister and Paolo work on in Rules of Engagement, Book 2 while in London are not actually set in London). These go onto the book page instead.
  • Locations that don't have a location page are not added via bullet point. Their images belong to the gallery of the respective book page. If there are several locations in a book and if each location has several images, the individual locations get separate tabbers depending on how many pictures there are.
• Miscellaneous.
  • This section is for any pictures taken in-game.

The coding is as follows:

Sneak Peeks

< gallery >

</ gallery >

Pre-Book Sneak Peeks & Information

< gallery >

</ gallery >

Featured Locations

* [[ name of location goes here ]]

< gallery >

</ gallery >

Miscellaneous

< gallery >

</ gallery >

Tip:

• When editing these, take out the spaces between the < and "gallery" and >. This was just to show the coding.
• If unsure how and where to add an image, please contact an admin, moderator or regular gallery editor.

Spoilers

To avoid trivia sections from being too long, the Spoilers section was later introduced. This section usually includes information about the book that does not come from the book itself but from one of the official Pixelberry social media or from a writer's account. Every time new information is published online, for example in a blog or by a writer's tweet, this information goes best here. Each new information gets its own bullet point and the order of the bullet points is chronological. If there's a date available of when the information was published, please add it. If the information comes from a source still available to be linked, please provide the link. In the rare case the book is never talked about online, the section can be left out.

Here are some examples from The Royal Romance, Book 3 and Blades of Light and Shadow, Book 1:

* On February 23, 2018, it was confirmed that Book 3 will debut on Friday, March 2, 2018.<ref>http://www.pixelberrystudios.com/blog/2018/2/23/the-royal-romance-book-3</ref><ref>https://twitter.com/PlayChoices/status/966770849804992513</ref>

On February 23, 2018, it was confirmed that Book 3 would debut on Friday, March 2, 2018.

* On February 26, 2018, Pixelberry released the soundtracks of ''The Royal Romance'' for the return of Book 3.<ref>https://twitter.com/PlayChoices/status/968305764359028737</ref>

On February 26, 2018, Pixelberry released the soundtracks of The Royal Romance for the return of Book 3.

During the livestream on April 26, 2019, it was teased that the new fantasy book is very new and very different with amazing art and love interests.

Livestreams are usually only temporarily available and therefore cannot be linked to anymore, so it is okay to just state when the livestream was held and what was revealed in it.

Trivia

The trivia section is for fun facts or things revealed in-game relating to the book and its characters. These can include references to other series or other pop culture references, the book being mentioned in other Choices series, information on plot similarities with other stories, information on changed chapter summaries or titles or about partial rewrites of individual scenes, and so on.

Tips:

• 1. Remember that some things important to the plot maybe be applicable.
• 2. Remember that if for example, a Pixelberry employee confirms something about a book and there is a link or photo available, put it in the gallery or add it as a reference (and it will add credibility to the claim).

References

References are the very last section on any page. It provides the evidence (links) for trivia points and are also used for quotes.

The code needed to make links show up properly on the actual page is:

<references/>

Other Rules

As always, practice netiquette.

• Avoid CAPS as that equals SHOUTING.
• Avoid excessive spacing for "dramatic effect".
• If you encounter a NSFW (not safe for work) official Choices image, such as Frank, please do not hesitate to use the {{NSFW}} template on the top of the page.

Confused?

Lastly, if there is any confusion about any of the things listed above or questions regarding subjects not listed here, please contact Fearless Diva or any of the other daily editors for advice.