From 93b79ef9ebafcfccd0d239ffd06e2b547e209e3d Mon Sep 17 00:00:00 2001 From: Yorhel Date: Thu, 8 Feb 2018 16:06:17 +0100 Subject: Store d+ pages in the DB as versioned entries + use markdown This touches a bunch of things: - Adds a new first-class database entry type - Removes the d+.+.+ BBCode link syntax, adds a new d+#+ and d+#+.+ link syntax (references have been updated where possible) - Adds a new dependency on Text::MultiMarkdown --- data/docs/10 | 115 --- data/docs/11 | 1870 ------------------------------------------------- data/docs/12 | 190 ----- data/docs/13 | 66 -- data/docs/14 | 162 ----- data/docs/15 | 67 -- data/docs/16 | 45 -- data/docs/2 | 257 ------- data/docs/3 | 160 ----- data/docs/4 | 76 -- data/docs/5 | 90 --- data/docs/6 | 138 ---- data/docs/7 | 69 -- data/docs/9 | 80 --- data/docs/incomplete | 4 - data/docs/index | 19 - data/docs/notfinished | 4 - 17 files changed, 3412 deletions(-) delete mode 100644 data/docs/10 delete mode 100644 data/docs/11 delete mode 100644 data/docs/12 delete mode 100644 data/docs/13 delete mode 100644 data/docs/14 delete mode 100644 data/docs/15 delete mode 100644 data/docs/16 delete mode 100644 data/docs/2 delete mode 100644 data/docs/3 delete mode 100644 data/docs/4 delete mode 100644 data/docs/5 delete mode 100644 data/docs/6 delete mode 100644 data/docs/7 delete mode 100644 data/docs/9 delete mode 100644 data/docs/incomplete delete mode 100644 data/docs/index delete mode 100644 data/docs/notfinished (limited to 'data/docs') diff --git a/data/docs/10 b/data/docs/10 deleted file mode 100644 index 0630d580..00000000 --- a/data/docs/10 +++ /dev/null @@ -1,115 +0,0 @@ -:TITLE:Tags & traits -:INC:index - - -:SUB:Introduction -

- VNDB has a system for tags and one for traits. Tags are used to categorize - visual novels, while traits tell something about characters. This - also makes them somewhat different in use. This page describes some general - guidelines and tips on using tags and traits. -

- - - -:SUB:Tags -

- Tags can be assigned to visual novel entries using a voting system. Every user - can add a tag to a visual novel by going to the "modify tags" tab of a visual - novel page. -

- -:SUBSUB:Tag voting -

Tags can be assigned a vote from -3 to 3. This vote should be interpreted as - follows:

-
    -
  1. -3: This tag really doesn't apply to the VN.
    2. -
  2. -2 and -1: These not very often used, but can be useful to - show that you disagree, but are not 100% sure.
    3. -
  3. 0: It is possible to change your vote to '0' to remove it.
    4. -
  4. 1: The tag does apply to the visual novel, but is not too apparent - or only plays a minor role.
    5. -
  5. 2: The tag certainly applies to the visual novel.
    6. -
  6. 3: The tag applies, is very apparent and plays a major role.
    7. -
-


- While everyone is pretty much free to link any tag to any visual novel, please - keep the following in mind while voting: -

- - - -:SUBSUB:Tag creation guidelines -

- New tags can be requested by everyone, but they'll have to be accepted by a - moderator before the tags will be browsable. Applying the following guidelines - significantly increases the chances that your tag will be accepted and lowers - the workload of the moderator team. -

- - - - -:SUB:Traits -

- Traits can be assigned to characters. Contrary to tags, traits can't be voted - on. Instead, traits are part of the editing system, and modifying the traits - for a certain character involves editing the character entry itself. -

- -:SUBSUB:Assigning traits -

- Unlike tags, traits don't have any "levels": a trait either applies to the - character or it does not. Here are some guidelines and tips when assigning - traits to characters: -

- - -:SUBSUB:Trait creation -

- Anyone can request new traits to be added to the database. However, these need - to be approved by a moderator before they can actually be assigned to a - character.

- Traits are categorized into "groups", the top-most trait in the tree - defines in which group a trait is. Unlike tags, traits don't need to have a - globally unique name, but they must be unique and self-describing within the - same group. For example, there can be multiple traits with the name "Blue", - but one is in the "Hair" group while the other is in the "Eyes" group. So - make sure to keep the group in mind when naming a trait.

- Read the descriptions of the various trait groups and meta traits to get a - feel on how they are supposed to be used. -

- diff --git a/data/docs/11 b/data/docs/11 deleted file mode 100644 index 77e7cf66..00000000 --- a/data/docs/11 +++ /dev/null @@ -1,1870 +0,0 @@ -:TITLE:Public Database API -:INC:index - -:SUB:Introduction -

- This document describes the public API of VNDB and is intended to be read by - programmers. This API allows programs and websites to access (parts of) the - VNDB database without actually visiting the website. -

- In addition to this real-time API, we also provide some information in the - form of database dumps. -

-

- -Usage terms -

- This service is free for non-commercial use. The API is provided on a - best-effort basis, no guarantees are made about the stability or applicability - of this service. -

-
- -Design goals - -
- -Design overview - -
- -Limits -

The following limits are enforced by the server, in order to limit the -server resources and prevent abuse of this service.

- -

- These limits may sound strict, but in practice you won't have to worry much - about it. As long as your application properly waits when the server replies - with a "throttle" error, everything will be handled automatically. In the event - that your application does require more resources, don't hesitate to ask. -

- - -
-Connection info: -
-
Host
api.vndb.org
-
Port (plain tcp)
19534 ('VN')
-
Port (TLS)
19535
For improved security, make sure to verify that the certificate is valid for 'api.vndb.org' and is signed by a trusted root (in particular, by Let's Encrypt).
-
- - - -:SUB:Request/response syntax -

- The VNDB API uses the JSON format for data in various places, this document assumes - you are familiar with it. See JSON.org for a quick - overview and RFC 4627 - for the glory details. -

- The words object, array, value, string, - number and integer refer to the JSON data types. In addition the following - definitions are used in this document: -

-
-
request or command
- Message sent from the client to the server. -
response
- Message sent from the server to the client. -
whitespace
- Any sequence of the following characters: space, tab, line feed and carriage - return. (hexadecimal: 20, 09, 0A, 0D, respectively). This is in line with the - definition of whitespace in the JSON specification. -
date
- A string signifying a date (in particular: release date). The - following formats are used: "yyyy" (when day and month are unknown), "yyyy-mm" - (when day is unknown) "yyyy-mm-dd", and "tba" (To Be Announced). If the year is - not known and the date is not "tba", the special value null is used. -
-
-
- -Message format -

- A message is formatted as a command or response name, followed by any number of - arguments, followed by the End Of Transmission character (04 in hexadecimal). - Arguments are separated by one or more whitespace characters, and any sequence - of whitespace characters is allowed before and after the message.
- The command or response name is an unescaped string containing only lowercase - alphabetical ASCII characters, and indicates what kind of command or response - this message contains.
- An argument can either be an unescaped string (not containing whitespace), any - JSON value, or a filter string. The following two examples demonstrate a - 'login' command, with an object as argument. Both messages are equivalent, as - the whitespace is ignored. '0x04' is used to indicate the End Of Transmission - character. -

-
- login {"protocol":1,"username":"ayo"}0x04
-
- login {
-  "protocol" : 1,
-  "username" : "ayo"
- }
- 0x04
-
-The 0x04 byte will be ommitted in the other examples in this document. It is -however still required.
- -
-Filter string syntax -

- Some commands accept a filter string as argument. This argument is formatted - similar to boolean expressions in most programming languages. A filter consists - of one or more expressions, separated by the boolean operators "and" or - "or" (lowercase). Each filter expression can be surrounded by parentheses to - indicate precedence, the filter argument itself must be surrounded by parentheses. -
- An expression consists of a field name, followed by an - operator and a value. The field name must consist entirely of - lowercase alphanumeric characters and can also contain an underscore. The - operator must be one of the following characters: =, !=, <, <=, >, - >= or ~. The value can be any valid JSON value. Whitespace - characters are allowed, but not required, between all expressions, field names, - operators and values.
- The following two filters are equivalent: -

-
- (title~"osananajimi"or(id=2))
-
- (
-   id = 2
-   or
-   title ~ "osananajimi"
- )
-
-

More complex filters are also possible:

-
- ((platforms = ["win", "ps2"] or languages = "ja") and released > "2009-01-10")
-
-

See the individual commands for more details.

- - -:SUB:The 'login' command -
- login {"protocol":1,"client":"test","clientver":0.1,"username":"ayo","password":"hi-mi-tsu!"}
-
-

- Every client is required to login before issuing other commands. The login - command accepts a JSON object as argument. This object has the following members: -

-
-
protocol
An integer that indicates which protocol version the client implements. Must be 1.
-
client
- A string identifying the client application. Between the 3 and 50 characters, - must contain only alphanumeric ASCII characters, space, underscore and hyphens. - When writing a client, think of a funny (unique) name and hardcode it into - your application. -
clientver
A number or string indicating the software version of the client.
-
username
(optional) String containing the username of the person using the client.
-
password
(optional) String, password of that user in plain text.
-
-

- The server replies with either 'ok' (no arguments), or 'error' (see below). - Note that logging in using a username and password is optional, but some - commands are only available when logged in. It is strongly recommended to - connect with TLS when logging in with a username and password. -

- - -:SUB:The 'dbstats' command -

- This command gives the global database statistics that are visible in the main - menu of the site. The command is simply: -

-
- dbstats
-
-

And the response has the following format:

-
- dbstats stats
-
-

Where stats is a JSON object with integer values. Example response:

-
- dbstats {"users":49084,
-          "threads":3998,
-          "tags":1627,
-          "releases":28071,
-          "producers":3456,
-          "chars":14046,
-          "posts":52470,
-          "vn":13051,
-          "traits":1272}
-
- - -:SUB:The 'get' command -

- This command is used to fetch data from the database. It accepts 4 arguments: - the type of data to fetch (e.g. visual novels or producers), what part of that - data to fetch (e.g. only the VN titles, or the descriptions and relations as - well), a filter expression, and lastly some options. -

-
- get type flags filters options
-
-

- type and flags are unescaped strings. The accepted values for type are - documented below. flags is a comma-separated list of flags indicating what - info to fetch. The filters, available flags and their meaning are documented - separately for each type. The last options argument is optional, and - influences the behaviour of the returned results. When present, options - should be a JSON object with the following members (all are optional): -

-
-
page
- integer, used for pagination. Page 1 (the default) returns the first 10 - results (1-10), page 2 returns the following 10 (11-20), etc. (The actual - number of results per page can be set with the "results" option below). -
results
- integer, maximum number of results to return. Also affects the "page" option - above. For example: with "page" set to 2 and "results" set to 5, the second - five results (that is, results 6-10) will be returned. Default: 10. -
sort
- string, the field to order the results by. The accepted field names differ - per type, the default sort field is the ID of the database entry. -
-
reverse
boolean, default false. Set to true to reverse the order of the results.
-
-

- The following example will fetch basic information and information about the - related anime of the visual novel with id = 17: -

-
- get vn basic,anime (id = 17)
-
-

- The server will reply with a 'results' message, this message is followed by a - JSON object describing the results. This object has three members: 'num', which - is an integer indicating the number of results returned, 'more', which is true - when there are more results available (i.e. increasing the page option - described above will give new results) and 'items', which contains the results - as an array of objects. For example, the server could reply to the previous - command with the following message: -

-
- results {"num":1, "more":false, "items":[{
-   "id": 17, "title": "Ever17 -the out of infinity-", "original": null,
-   "released": "2002-08-29", "languages": ["en","ja","ru","zh"],
-   "platforms": ["drc","ps2","psp","win"],"anime": []
- }]}
-
-

- Note that the actual result from the server can (and likely will) be formatted - differently and that the order of the members may not be the same. What each - member means and what possible values they can have differs per type and is - documented below. -

- -:SUBSUB:get vn -

The following members are returned from a 'get vn' command:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
id-integernoVisual novel ID
titlebasicstringnoMain title
originalbasicstringyesOriginal/official title.
releasedbasicdate (string)yesDate of the first release.
languagesbasicarray of stringsnoCan be an empty array when nothing has been released yet.
orig_langbasicarray of stringsnoLanguage(s) of the first release. Can be an empty array.
platformsbasicarray of stringsnoCan be an empty array when unknown or nothing has been released yet.
aliasesdetailsstringyesAliases, separated by newlines.
lengthdetailsintegeryesLength of the game, 1-5
descriptiondetailsstringyesDescription of the VN. Can include formatting codes as described in d9.3.
linksdetailsobjectno - Contains the following members:
- "wikipedia", string, name of the related article on the English Wikipedia.
- "encubed", string, the URL-encoded tag used on encubed.
- "renai", string, the name part of the url on renai.us.
- All members can be null when no links are available or known to us. -
imagedetailsstringyesHTTP link to the VN image.
image_nsfwdetailsbooleannoWhether the VN image is flagged as NSFW or not.
animeanimearray of objectsno - (Possibly empty) list of anime related to the VN, each object has the following members:
- "id", integer, AniDB ID
- "ann_id", integer, AnimeNewsNetwork ID
- "nfo_id", string, AnimeNfo ID
- "title_romaji", string
- "title_kanji", string
- "year", integer, year in which the anime was aired
- "type", string
- All members except the "id" can be null. Note that this data is courtesy of AniDB, - and may not reflect the latest state of their information due to caching. -
relationsrelationsarray of objectsno - (Possibly empty) list of related visual novels, each object has the following members:
- "id", integer
- "relation", string, relation to the VN
- "title", string, (romaji) title
- "original", string, original/official title, can be null
- "official", boolean. -
tagstagsarray of arraysno - (Possibly empty) list of tags linked to this VN. Each tag is represented as - an array with three elements:
- tag id (integer),
- score (number between 0 and 3),
- spoiler level (integer, 0=none, 1=minor, 2=major)
- Only tags with a positive score are included. Note that this list may be - relatively large - more than 50 tags for a VN is quite possible.
- General information for each tag is available in the tags - dump. Keep in mind that it is possible that a tag has only recently been - added and is not available in the dump yet, though this doesn't happen - often. -
popularitystatsnumbernoBetween 0 (unpopular) and 100 (most popular).
ratingstatsnumbernoBayesian rating, between 1 and 10.
votecountstatsintegernoNumber of votes.
screensscreensarray of objectsno - (Possibly empty) list of screenshots, each object has the following members:
- "image", string, URL of the full-size screenshot
- "rid", integer, release ID
- "nsfw", boolean
- "height", integer, height of the full-size screenshot
- "width", integer, width of the full-size screenshot -
staffstaffarray of objectsno - (Possibly empty) list of staff related to the VN, each object has the following members:
- "sid", integer, staff ID
- "aid", integer, alias ID
- "name", string
- "original", string, possibly null
- "role", string
- "note", string, possibly null -
-

Sorting is possible on the following fields: id, title, released, popularity, rating, votecount.


- -

'get vn' accepts the following filter expressions:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		= != > >= < <=
= !=		 - When you need to fetch info about multiple VNs, it is recommended to do so - in one command using an array of integers as value. e.g. (id = [7,11,17]). -
titlestring= != ~ 
originalnull
string		= !=
= != ~		 
firstcharnull
string		= !=
= !=		 - Filter by the first character of the title, similar to the - VN browser interface. The character - must either be a lowercase 'a' to 'z', or null to match all titles not - starting with an alphabetic character. -
releasednull
date (string)		= !=
= != > >= < <=		 - Note that matching on partial dates (released = "2009") doesn't do what - you want, use ranges instead, e.g. (released > "2008" and released <= "2009"). -
platformsnull
string
array of strings
= !=		 
languagesnull
string
array of strings
= !=		 
orig_langstring
array of strings		= != 
searchstring~ - This is not an actual field, but performs a search on the titles of the visual - novel and its releases. Note that the algorithm of this search may change and - that it can use a different algorithm than the search function on the website. -
tagsint
array of ints		= != - Find VNs by tag. When providing an array of ints, the '=' filter will return - VNs that are linked to any (not all) of the given tags, the '!=' filter will - return VNs that are not linked to any of the given tags. You can combine - multiple tags filters with 'and' and 'or' to get the exact behavior you - need.
- This filter may used cached data, it may take up to 24 hours - before a VN will have its tag updated with respect to this filter.
- VNs that are linked to childs of the given tag are also included.
- Be warned that this filter ignores spoiler settings, fetch the tags - associated with the returned VN to verify the spoiler level. -
- -:SUBSUB:get release -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
id-integernoRelease ID
titlebasicstringnoRelease title (romaji)
originalbasicstringyesOriginal/official title of the release.
releasedbasicdate (string)yesRelease date
typebasicstringno"complete", "partial" or "trial"
patchbasicbooleanno 
freewarebasicbooleanno 
doujinbasicbooleanno 
languagesbasicarray of stringsno 
websitedetailsstringyesOfficial website URL
notesdetailsstringyesRandom notes, can contain formatting codes as described in d9.3
minagedetailsintegeryesAge rating, 0 = all ages.
gtindetailsstringyesJAN/UPC/EAN code. This is actually an integer, but formatted as a string to avoid an overflow on 32bit platforms.
catalogdetailsstringyesCatalog number.
platformsdetailsarray of stringsnoEmpty array when platform is unknown.
mediadetailsarray of objectsno - Objects have the following two members:
- "medium", string
- "qty", integer, the quantity. null when it is not applicable for the medium.
- An empty array is returned when the media are unknown. -
resolutiondetailsstringyes
voiceddetailsintegeryes1 = Not voiced, 2 = Only ero scenes voiced, 3 = Partially voiced, 4 = Fully voiced
animationdetailsarray of integersno - The array has two integer members, the first one indicating the story - animations, the second the ero scene animations. Both members can be null - if unknown or not applicable.
-
- When not null, the number indicates the following: 1 = No animations, 2 = - Simple animations, 3 = Some fully animated scenes, 4 = All scenes fully - animated. -
vnvnarray of objectsno - Array of visual novels linked to this release. Objects have the following members: - id, title and original. These are the same as the members of the "get vn" command. -
producersproducersarray of objectsno - (Possibly empty) list of producers involved in this release. Objects have the following members:
- "id", integer
- "developer", boolean,
- "publisher", boolean,
- "name", string, romaji name
- "original", string, official/original name, can be null
- "type", string, producer type -
-

Sorting is possible on the 'id', 'title' and 'released' fields.


- -

Accepted filters:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		= != > >= < <=
= !=		 
vninteger
array of integers		= !=Find releases linked to the given visual novel ID.
producerinteger=Find releases linked to the given producer ID.
titlestring= != ~ 
originalnull
string		= !=
= != ~		 
releasednull
date (string)		= !=
= != > >= < <=		Note about released filter for the vn type also applies here.
patchboolean= 
freewareboolean= 
doujinboolean= 
typestring= != 
gtinint= !=Value can also be escaped as a string (if you risk an integer overflow otherwise)
catalogstring= != 
languagesstring
array of strings		= != 
platformsstring
array of strings		= != 
- -:SUBSUB:get producer -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
id-integernoProducer ID
namebasicstringno(romaji) producer name
originalbasicstringyesOriginal/official name
typebasicstringnoProducer type
languagebasicstringnoPrimary language
linksdetailsobjectno - External links, object has the following members:
- "homepage", official homepage,
- "wikipedia", title of the related article on the English wikipedia.
- Both values can be null. -
aliasesdetailsstringyesList of alternative names, separated by a newline
descriptiondetailsstringyesDescription/notes of the producer, can contain formatting codes as described in d9.3
relationsrelationsarray of objectsno - (possibly empty) list of related producers, each object has the following members:
- "id", integer, producer ID,
- "relation", string, relation to the current producer,
- "name", string,
- "original", string, can be null -
-

Sorting is possible on the 'id' and 'name' fields.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		= != > >= < <=
= !=		 
namestring= != ~ 
originalnull
string		= !=
= != ~		 
typestring= != 
languagestring
array of strings		= != 
searchstring~Not an actual field. Performs a search on the name, original and aliases fields.
- -:SUBSUB:get character -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
id-integernoCharacter ID
namebasicstringno(romaji) name
originalbasicstringyesOriginal (kana/kanji) name
genderbasicstringyes"m" (male), "f" (female) or "b" (both)
bloodtbasicstringyesBlood type, "a", "b", "ab" or "o"
birthdaybasicarrayno - Array of two numbers: day of the month (1-31) and the month (1-12). Either can be null. -
aliasesdetailsstringyesAlternative names, separated with a newline.
descriptiondetailsstringyesDescription/notes, can contain formatting codes as described in d9.3. May also include [spoiler] tags!
imagedetailsstringyesHTTP link to the character image. Always (supposed to be) SFW.
bustmeasintegeryescm
waistmeasintegeryescm
hipmeasintegeryescm
heightmeasintegeryescm
weightmeasintegeryeskg
traitstraitsarray of arraysno(Possibly empty) list of traits linked to this character. Each trait is - represented as an array of two elements: The trait id (integer) and the - spoiler level (integer, 0-2). General information for each trait is - available in the traits dump.
vnsvnsarray of arraysnoList of VNs linked to this character. Each VN is an array of 4 elements: - VN id, release ID (0 = "all releases"), spoiler level (0-2) and the role - (string).
- Available roles: "main", "primary", "side" and "appears".
voicedvoicedarray of objectsnoList of voice actresses (staff) that voiced this character, per VN. Each - staff/VN is represented as a object with the following members:
- "id", integer, staff ID
- "aid", integer, the staff alias ID being used
- "vid", integer, VN id
- "note", string
- The same voice actor may be listed multiple times if this entry is - character to multiple visual novels. Similarly, the same visual novel may - be listed multiple times if this character has multiple voice actors in the - same VN. -
-

Sorting is possible on the 'id' and 'name' fields.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		= != > >= < <=
= !=		 
namestring= != ~ 
originalnull
string		= !=
= != ~		 
searchstring~Not an actual field. Performs a search on the name, original and aliases fields.
vninteger
array of integers		=Find characters linked to the given visual novel ID(s). Note that this - may also include characters that are normally hidden by spoiler settings. -
traitsint
array of ints		= != - Find chars by traits. When providing an array of ints, the '=' filter will return - chars that are linked to any (not all) of the given traits, the '!=' filter will - return chars that are not linked to any of the given traits. You can combine - multiple trait filters with 'and' and 'or' to get the exact behavior you - need.
- This filter may used cached data, it may take up to 24 hours - before a char entry will have its traits updated with respect to this filter.
- Chars that are linked to childs of the given trait are also included.
- Be warned that this filter ignores spoiler settings, fetch the traits - associated with the returned char to verify the spoiler level. -
- - -:SUBSUB:get staff -

-Unlike other database entries, staff have more than one unique identifier.
-There is the main 'staff ID', which uniquely identifies a person and is what -the staff pages on the site represent.
-Additionally, every staff name and alias also has its own unique identifier, -which is referenced from other database entries to identify which alias was -used. This identifier is generally hidden on the site and aliases do not have -their own page, but the IDs are exposed in this API in order to facilitate -linking between VNs/characters and staff.
-
-Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
id-integernoStaff ID
namebasicstringnoPrimary (romaji) staff name
originalbasicstringyesPrimary original name
genderbasicstringyes
languagebasicstringnoPrimary language
linksdetailsobjectno - External links, object has the following members:
- "homepage", official homepage,
- "wikipedia", title of the related article on the English wikipedia.
- "twitter", name of the twitter account.
- "anidb", AniDB creator ID.
- All values can be null. -
descriptiondetailsstringyesDescription/notes of the staff, can contain formatting codes as described in d9.3
aliasesaliasesarray of arraysno - List of names and aliases. Each name is represented as an array with the - following elements: Alias ID, name (romaji) and the original name.
- This list also includes the "primary" name. -
main_aliasaliasesintegernoID of the alias that is the "primary" name of the entry
vnsvnsarray of objectsno - List of visual novels that this staff entry has been credited in (excluding - character voicing). Each vn is represented as an object with the following - members:
- "id", integer, visual novel id
- "aid", integer, alias ID of this staff entry
- "role", string
- "note", string, may be null if unset
- The same VN entry may appear multiple times if the staff has been credited - for multiple roles. -
voicedvoicedarray of objectsno - List of characters that this staff entry has voiced. Each object has the - following members:
- "id", integer, visual novel id
- "aid", integer, alias ID of this staff entry
- "cid", integer, character ID
- "note", string, may be null if unset
- The same VN entry may appear multiple times if the staff has been credited - for multiple characters. Similarly, the same character may appear multiple - times if it has been linked to multiple VNs. -
-

Sorting is possible on the 'id' field.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		= != > >= < <=
= !=		 
aidinteger
array of integers		=
=		 
searchstring~Searched through all aliases, both the romanized and original names.
- - -:SUBSUB:get user -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
idbasicintegernoUser ID
usernamebasicstringno
-

The returned list is always sorted on the 'id' field.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
idinteger
array of integers		=The special value '0' is recognized as the currently logged in user.
usernamestring
array of strings		= != ~
=
- - -:SUBSUB:get votelist -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
uidbasicintegernoUser ID
vnbasicintegernoVisual Novel ID
votebasicintegernoIn the range of 10 (lowest) to 100 (highest). These are displayed on the site as a fractional number between 1 and 10.
addedbasicintegernoUnix timestamp of when this vote has been added.
-

The returned list is always sorted on the 'vn' field.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
uidinteger=The special value '0' is recognized as the currently logged in user.
vninteger
array of integers		= != > < >= <=
= !=		Visual novel ID.
-

- Note: It's possible that a user has voted on a VN that has been deleted. The - vote is still included this list, but a 'get vn' command on its id will not - return anything.
- Note#2: This command will not return any results for users who have their vote - list hidden from the public in their preferences, except when the user itself - has logged into the API. -

- -:SUBSUB:get vnlist -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
uidbasicintegernoUser ID
vnbasicintegernoVisual Novel ID
statusbasicintegerno0=Unknown, 1=playing, 2=finished, 3=stalled, 4=dropped.
addedbasicintegernoUnix timestamp of when this item has been added.
notesbasicstringyesUser-set notes
-

The returned list is always sorted on the 'vn' field.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
uidinteger=The special value '0' is recognized as the currently logged in user.
vninteger
array of integers		= != > < >= <=
= !=		Visual novel ID.
-

The notes mentioned under 'get votelist' also apply here.

- -:SUBSUB:get wishlist -

Returned members:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberFlagTypenullDescription
uidbasicintegernoUser ID
vnbasicintegernoVisual Novel ID
prioritybasicintegerno0=high, 1=medium, 2=low, 3=blacklist.
addedbasicintegernoUnix timestamp of when this item has been added.
-

The returned list is always sorted on the 'vn' field.


- -

The following filters are recognised:

- - - - - - - - - - - - - - - - - - - -
FieldValueOperators 
uidinteger=The special value '0' is recognized as the currently logged in user.
vninteger
array of integers		= != > < >= <=
= !=		Visual novel ID.
-

The notes mentioned under 'get votelist' also apply here.

- - -:SUB:The 'set' command -

- The set command can be used to modify stuff in the database. It can only be - used when logged in as a user. The command has the following syntax: -

-
- set type id fields
-
-

- Here, type is similar to the type argument to the 'get' command, - id is the (integer) identifier of the database entry to change, and - fields is an object with the fields to set or modify. If the - fields object is not present, the set command works as a 'delete'. The - interpretation of the id and fields arguments depend on the - type, and are documented in the sections below.
-
- But before that, let me present some examples to get a feel on what the - previous paragraph meant. The following example adds a '10' vote on v17, or changes the vote to a 10 if a previous vote was - already present: -

-
- set votelist 17 {"vote":100}
-
-

And here's how to remove the previous vote:

-
- set votelist 17
-
-

- 'set' replies with a simple 'ok' on success, or with an 'error' (see below) on - failure. Note that, due to my laziness, no error is currently returned if the - identifier does not exist. So voting on a VN that does not exist will return - an 'ok', but no vote is actually added. This behaviour may change in the - future. Note that this API doesn't care whether the VN has been deleted or - not, so you can manage votes and stuff for deleted VNs (Which isn't very - helpful, because 'get vn' won't return a thing for deleted VNs). -

- -:SUBSUB:set votelist -

- This command facilitates adding, removing and modifying votes. The - identifier argument is the visual novel ID, and the following fields - are recognized: -

- - - - - - - - - - - -
FieldTypeDescription
voteintegerSame as the 'vote' member returned by 'get votelist', in the range 10 to 100. This field has no default; it must always be present.
-

- The 'added' member returned by 'get votelist' is, as its name implies, only - set when the vote is added. Changing an existing vote will not update the - 'added' field. -

- -:SUBSUB:set vnlist -

- This command facilitates adding, removing and modifying your VN list. The - identifier argument is the visual novel ID, and the following fields - are recognized: -

- - - - - - - - - - - - - - - - -
FieldTypeDescription
statusintegerSame as the 'status' member returned by 'get vnlist'. Default: 0
notesstringSame as the 'notes' member returned by 'get vnlist'. An empty string is considered equivalent to 'null'. A newline is currently not allowed because the web interface won't handle them well. Default: null.
-

- Sames notes about the 'added' member for 'set votelist' applies here.
- Also note that, when removing a vnlist item, any releases associated with the - VN will be removed from the users' list as well. The release list - functionality is not currently exposed to the API, so this will only be - visible when the web interface is used. -

- -:SUBSUB:set wishlist -

- This command facilitates adding, removing and modifying VNs from your - wishlist. The identifier argument is the visual novel ID, and the - following fields are recognized: -

- - - - - - - - - - - -
FieldTypeDescription
priorityintegerSame as the 'priority' member returned by 'get wishlist'.
-

- Sames notes about the 'added' member for 'set votelist' applies here.
-

- - - -:SUB:The 'error' response -

- Every command to the server can receive an 'error' response, this response has one - argument: a JSON object containing at least a member named "id", which identifies - the error, and a "msg", which contains a human readable message explaining what - went wrong. Other members are also possible, depending on the value of "id". - Example error message: -

-
- error {"id":"parse", "msg":"Invalid command or argument"}
-
-

- Note that the value of "msg" is not directly linked to the error identifier: - the message explains what went wrong in more detail, there are several - different messages for the same id. The following error identifiers are currently - defined: -

-
-
parse
Syntax error, unknown command or invalid argument type.
-
missing
A JSON object argument is missing a required member. The name of which is given in the additional "field" member.
-
badarg
A JSON value is of the wrong type or in the wrong format. The name of the incorrect field is given in a "field" member.
-
needlogin
Need to be logged in to issue this command.
-
throttled
- You have used too many server resources within a short time, and need to wait - a bit before sending the next command. The type of throttle is given in the - "type" member, and the "minwait" and "fullwait" members tell you how long you - need to wait before sending the next command and when you can start bursting - again (this is the recommended waiting time), respectively. Both values are in - seconds, with a precision of 0.1 seconds. -
-
auth
(login) Incorrect username/password combination.
-
loggedin
(login) Already logged in. Only one successful login command can be issues on one connection.
-
gettype
(get) Unknown type argument to the 'get' command.
-
getinfo
(get) Unknown info flag to the 'get' command. The name of the unrecognised flag is given in an additional "flag" member.
-
filter
(get) Unknown filter field or invalid combination of field/operator/argument type. Includes three additional members: "field", "op" and "value" of the incorrect expression.
-
settype
(set) Unknown type argument to the 'set' command.
-
- - - -:SUB:Change Log -

- This section lists the changes made in each version of the VNDB code. - Check out the announcements board for more information about updates. -

-

-2018-02-07 - -2017-08-14 - -2017-06-21 - -2017-05-22 - -2017-04-28 because screw version numbers - -2.27 - -2.25 - -2.23 - -2.15 - -2.12 - - diff --git a/data/docs/12 b/data/docs/12 deleted file mode 100644 index 8149343e..00000000 --- a/data/docs/12 +++ /dev/null @@ -1,190 +0,0 @@ -:TITLE:Adding/Editing Characters -:INC:index - - -:SUB:Introduction -

- Characters represent persons, animals and things within a visual novel. Any - character in a visual novel, no matter how obscure their role is, may be added - to the database, although it is recommended to at least add the more important - characters first. When adding characters, try to be complete: That is, try to - add as many characters of a single visual novel, rather than adding a single - character to many VNs. -

- - -:SUB:Instances -

-You can link two (or more) characters with an "instance relationship" when they are, in some way, the same person. -

-:SUBSUB: Where instances might be suitable - - -:SUBSUB:Where instances might not be suitable - - -:SUBSUB:How to use instances -

-To link two (or more) characters with an instance relationship, you must choose -one character to be the "main character". All others will be "instance -characters". (Do not confuse this with a character's role in a visual novel.) -Usually, the most often seen or least spoiling character should be the "main -character".
-Do not fill the "Instance of" field when editing the "main character", but fill -it for the "instance characters". If the instance relation is a spoiler, make -sure to mark it as such when editing the "instance characters". If the -existence of a character in a visual novel is a spoiler, see the Visual Novels section below. -

- - -:SUB:General info -
-
Name (romaji)
- Name of the character, in the latin alphabet. Check out the general editing guidelines for information on name order and - romanization. Try to use the full name when known. If the full name is not - known, then use either the first or last name. If even that isn't known, use - the name that is most commonly used to refer to this character in the story. - In the case the character is never referred to with a name or title (e.g. - it's the protagonist), "Unnamed" can be used as name.
- In some cases the full name is a spoiler, see the chapter on instances above - for some ways to handle that. -
Original name
- The actual name of the character, in the case it is not officially in the - latin alphabet. Leave empty if it's the same as the "Name (romaji)". If - possible, try to include a space between the given name and the surname. -
Aliases
- Other names this character is known by, such as nick names used by other - characters within the story. Since this field does not have any option to - hide spoilers, you shouldn't include spoilery names here. It is possible to - mention such aliases with a [spoiler] tag in the description. -
Description
- A short description of the character. While it is advised to keep the - spoilers to a minimum, you can use the usual formatting - codes such as [spoiler] to include spoilers while hiding them by default. - When using a description from external sources, check out the general editing guidelines for quoting rules. -
Gender
- Gender of the character. This is usually rather straightforward, but there - are some odd cases: (Reverse) traps should have their biological gender - filled out here. Futanari should be marked as "both".
- If the real gender is a spoiler, which is sometimes the case with traps, - leave this field at "Unknown". See the chapter on instances above if the - character "transforms" between a male and female version. -
Birthday
- Month and day of the character's birthday. Note that a year is not included. -
Bust / Waist / Hips
- BWH measurements, if known. - This information should either come from the game itself or from a reliable - source (usually the official homepage). Don't try to guess these!
- If the official source does not provide this information as a natural number, - the number should rounded to allow its use in the database. If the official - information is not in the metric system, convert the numbers and round them - before entering. -
Height
- Height of the character, in cm. The above note on natural numbers and the - metric system also applies here. -
Weight
- Weight of the character, in kg. The above note on natural numbers and the - metric system also applies here. -
Blood type
- Blood type, if known and applicable. This makes little sense if the character - isn't a human. -
-
- - -:SUB:Image -

- There is a lot of freedom with regards to uploading an image to a character - entry, but the following is a list of things to keep in mind: -

- - -:SUB:Traits -

- See the Tags & traits page for guidelines on the traits. -

- - -:SUB:Visual Novels -

- A character should always be linked to at least one visual novel entry, but may - be linked with more when it appears in multiple visual novels.
- If a character appears in all releases of the visual novel, with the possible - exception of trial releases, then simply keep one release and leave it at "All - / others". In other situations, mention explicitely in which releases the - character appears and which role they have in that release. Multiple releases - can be added with the same role and spoiler information.
- If a characters' role or the entire existance of that character in the visual - novel is a spoiler, make sure to mark it as such.
- The following roles are available: -

-
-
Protagonist
- The (or "a") protagonist. The person through which the story is told. Note - that a significant portion of the story has to be told through the eyes of - the character for it to be considered a protagonist. Some visual novels may - switch perspectives for a (relatively) short amount of time, but this does - not always make the character a protagonist. -
Main character
- A character that plays a major role in the story or gets a lot of screen - time. In general, a herione with an own route always qualifies and so do - sidekicks/classmates that are very often seen. -
Side character
- A character that plays a minor role or does not get a lot of screen time. - This is often the case for characters that appear only in a single branch or - a single part of the story, although this is not a mandatory. -
Makes an appearance
- This role is used for characters that only appear in the story for a short - while and have only very little to no lines of dialog. Often used for cameo appearances. -
-
-

- Note that there is no distinct line between these roles, and one could have - endless (and often rather pointless) discussions about the actual role of a - character. Simply assign the role that you think most naturally fits the - character. To get some inspiration, look around for characters in other visual - novels that play a somewhat similar role. -

- diff --git a/data/docs/13 b/data/docs/13 deleted file mode 100644 index ca99365b..00000000 --- a/data/docs/13 +++ /dev/null @@ -1,66 +0,0 @@ -:TITLE:How to Capture Screenshots - -:INC:index - - -:SUB:Introduction -Screenshots uploaded to VNDB must confirm to some strict guidelines. In -particular, they should not have any window borders and must be in the correct -resolution (precise to the pixel!). Uploading screenshots that do not confirm -to these rules will likely result in them getting deleted shortly afterwards. -This page is a tutorial on how to correctly capture screenshots using -various tools. - - -:SUB:IrfanView -
    -
  1. Download and install Irfanview from irfanview.com. Installation should be - fairly straight-forward.
    2. -
  2. Start Irfanview, you should get a window like this.
    3. -
  3. Hit the C key or go Options -> Capture/Screenshot to open - the capture - setup window.
    4. -
  4. Check the "Foreground window - client area" selection box. This - option makes sure that you won't see any window borders and that the - screenshot is already correctly cropped.
    5. -
  5. Set a hot key. Irfanview uses Ctrl+F11 by default, but since the Ctrl - is usually assigned to skipping in most games, you will probably want to - change it. To do so, left-click on the key area and press the desired key - combination. Alt+F11 should do the trick.
    6. -
  6. Check the "Save captured image as file", choose a destination folder and - select JPG in the "Save as" options.
    7. -
  7. Click "Options" to open the JPEG save options - window
    8. -
  8. Set the quality somewhere between 95 and 100.
    9. -
  9. Press "OK", and then press "Start" to close the capture setup window.
    10. -
-
-Now go to the visual novel you want to capture and press the configured hot key -at the desired moment. Irfanview will automatically capture and save the -screenshot in the chosen directory. These screenshots are suitable for -uploading to VNDB without further modifications. - - -:SUB:ShareX -
    -
  1. Download and install ShareX from getsharex.com.
    2. -
  2. Start ShareX, you should then get a window like this.
    3. -
  3. Go to Task settings and - adjust your capture settings and - image settings.
    4. - -
  4. You can set a custom hotkey for window capture: Go to - Hotkey settings and change the - default hotkey for window capture. -
    5. -
  5. Change the After capture tasks according to your preferences.
    6. -
  6. (Tip) If you want to change the directory where screenshots will be saved, go to Application settings and follow these steps.
    7. -
  7. (Tip) You can change the naming pattern of the saved screenshots by going to the Task settings and following these steps.
    8. -
-
-Now go to the visual novel you want to capture and press the configured hot key -at the desired moment. The saved screenshots can be uploaded to VNDB without -further modifications. diff --git a/data/docs/14 b/data/docs/14 deleted file mode 100644 index 18f403a7..00000000 --- a/data/docs/14 +++ /dev/null @@ -1,162 +0,0 @@ -:TITLE:Database Dumps -:INC:index - -:SUB:Introduction -

- This page lists and documents any provided database dumps. These dumps are - complimentary to the real-time API, and the usage terms - that apply to the API apply here as well. -

- - -:SUB:Tags -

- URL: https://vndb.org/api/tags.json.gz
- Updated: Every 24 hours.
- Size: ~240 KiB compressed, ~800 KiB uncompressed.
- This dump includes information about all (approved) VN tags in the JSON - format. The top-level type is an array of tags, and each tag is represented as - an object with the following members: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberTypenullDescription
idintegernoTag ID
namestringnoTag name
descriptionstringnoCan include formatting codes as described in d9.3.
metaboolnoWhether this is a meta tag or not.
vnsintegernoNumber of tagged VNs (including child tags)
catstringnoTag category/classification: "cont" for content, "ero" for sexual stuff, and "tech" for technical details.
aliasesarray of stringsno(Possibly empty) list of alternative names.
parentsarray of integersnoList of parent tags (empty for root tags).
-

- Tag names and their aliases are globally unique and self-describing. See the - tag creation guidelines for more information. -

- - -:SUB:Traits -

- URL: https://vndb.org/api/traits.json.gz
- Updated: Every 24 hours.
- Size: ~340 KiB compressed, ~1 MiB uncompressed.
- This dump includes information about all (approved) character traits in the - JSON format. The top-level type is an array of traits, and each trait is - represented as an object with the following members: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberTypenullDescription
idintegernoTrait ID
namestringnoTrait name
descriptionstringnoCan include formatting codes as described in d9.3.
metaboolnoWhether this is a meta trait or not.
charsintegernoNumber of characters on which this trait and any child traits is used.
aliasesarray of stringsno(Possibly empty) list of alternative names.
parentsarray of integersnoList of parent traits (empty for root traits).
-

- Unlike with tags, trait names and aliases are neither globally unique nor - self-describing. If you wish to display a trait (name) to the user, you - should do so in combination with its associated root trait. For example, - i112 is often displayed as "Eyes > Green", to - differentiate it with i50, which is "Hair > Green". -

- - -:SUB:Votes -

- URL: https://vndb.org/api/votes2.gz
- Updated: Every 24 hours.
- Size: ~2.8 MiB compressed, ~11.6 MiB uncompressed.
- This dump contains the VN votes of all users who did not mark their vote list - as private. Votes from known duplicate accounts or from users who voted on - unreleased VNs are also not included.
- Each line in the file represents a single vote. Each line contains the VN id, - user ID, vote, and date that the vote was cast, separated by a space. Votes - are as listed on the site, multiplied by 10 (i.e. in the range of 10 - 100). -

diff --git a/data/docs/15 b/data/docs/15 deleted file mode 100644 index 45f808df..00000000 --- a/data/docs/15 +++ /dev/null @@ -1,67 +0,0 @@ -:TITLE:Special Games -:INC:index - -:SUB:Introduction -

- This page lists a few games that are commonly discussed for inclusion in the - database and the reasoning for their inclusion or exclusion. Check d2.1 for the general inclusion guidelines. -

- -:SUB:Deleted Games -

- The following is a list of games that have been (proposed to be) included in - the database, but that were removed or rejected. These games are not - visual novels and will not be reinstated. -

- - -:SUB:Borderline Games -

- The following is a lists of few games that are included in the database, but - are very much borderline cases. When arguing for another game to be included, - do not, ever, refer to these games as examples. -

- diff --git a/data/docs/16 b/data/docs/16 deleted file mode 100644 index 036015fb..00000000 --- a/data/docs/16 +++ /dev/null @@ -1,45 +0,0 @@ -:TITLE:Adding/Editing Staff Members -:INC:index - -:SUB:Introduction -

- Staff entries represent individuals and groups that play significant roles in visual - novels production, such as script writers, character designers, artists, voice actors, - composers and singers. -

- -:SUB:General info -
-
Names
- People involved in visual novel production often hide behind multiple - aliases. These aliases can be listed here. Add only aliases that are actually - used in VN credits. Sometimes names with different Japanese spellings are - romanized equally. You may add such aliases, but in that case the original - spelling should be used when that name is being looked up in the VN staff - edit form.
-
- One of the aliases can be selected as the primary name of the staff entry. - Typically this is either the person's true name (if known, and if the person - has used their true name in the context of VNs) or, alternatively, the most - widely used alias.
-
- For each alias, the romaji field should contain the name in Latin alphabet. - The original name should contain the name as it is written in the original - script, and should be left blank if the name is already in the Latin - alphabet. Check out the general editing guidelines for - information on name order and romanization. If possible, try to include a - space between the given name and the surname. -
Gender
- Person's gender, if known. -
Primary language
- Native language, Japanese by default. -
Staff note
- Brief note describing biography, occupation and production companies affiliations, if any. - It's fine to leave this field empty if there's nothing much known about the person in question. -
Official page
- Link to the official page or blog. -
Additional links
- You could also provide links to Wikipedia entry, Twitter account and/or AniDB entry. Do - not specify the full URL for additional links, we only need a small part of it! -
-
diff --git a/data/docs/2 b/data/docs/2 deleted file mode 100644 index 3eded990..00000000 --- a/data/docs/2 +++ /dev/null @@ -1,257 +0,0 @@ -:TITLE:Adding/Editing a Visual Novel -:INC:index - -:SUB:What can be added to the database -

- For a game to qualify for inclusion in the database, it must meet one of the - following two requirements:

-

- -
    -
  1. Visual Novels that have the following characteristics: -
      -
    • Choices are the only allowed (but optional) form of interactivity. There - are no other gameplay elements (including stats-based gameplay in - dating/raising sims). Mini-games and simple mechanics, such as map-movenent, - are only allowed when they play a very minimal role – at least 99% of the - title should be made of pure reading.
      • -
    • The story is told employing one of the known Visual Novel presentation - methods such as ADV, NVL and their variations.
      • -
    -
    2. -
  2. Visual Novel / Game hybrids that have the following characteristics: -
      -
    • The game consistently uses the novel narrative for telling its story. - Examples include describing visuals, events, character actions or thoughts.
      - This point is ESSENTIAL - dialogues, no matter how extensive, are a - characteristic of such game genres as RPGs, adventure games, dating - simulations, etc., NOT of visual novels.
      • -
    • The story is told employing one of the known Visual Novel presentation - methods such as ADV, NVL and their variations, consistently and for - a significant length - at least 50% of the game should be made of pure, - VN-style reading.
      • -
    -
    3. -
- -

-
- Note: In some special cases, a game may be added even if it does not strictly - adhere to the above points. However, this is the decision of the moderators. Do - not add a game yourself expecting it to be an exception to the above rules. -
- See also the list of special games. -

- - -:SUB:General info -
-
Title (romaji)
- The title should be based upon the title of the original release.
- If the title uses the Latin alphabet, use our capitalisation guidelines.
- Otherwise, romanise according to our guidelines. -
Original title
- If the name is officially under a different title (usually because of different - character sets), put the original title here. -
Aliases
- Visual novels can be known under several names, use this field to add any aliases - and acronyms used around the net. Official titles of releases should not be added - here, as these are already listed in the releases. -
Description
- Short description of the main story. -
Length
- Very rough estimate of the time required to finish all endings of the visual novel. - To determine the length of a game, it's often better to ignore this time indication - and instead compare it with other games you've played. It's all relative, after all. -
External links
- Links to external resources about this visual novel. To get the URLs, go to the - sites (Wikipedia, - Novelnews.net, Renai.us and - Visual-novels.net), - search for a page about the game, and determine the ID or name of that page to fill - out in the text boxes. Do not specify the full URL, we only need a small part of - it! -
Related anime
- Some visual novels (e.g. Clannad and Utawarerumono) - have anime adaptions, and some visual novels were adapted from an anime series. Use - this field to specify these related anime for the visual novel.
- Anime should be specified using AniDB IDs. To add an - anime, just search for it on AniDB and add the numeric ID of the entry (found in the - aid=xxx part of the URL) to the edit field. Multiple IDs should be seperated - with a whitespace.
- If the visual novel already has a relation with an other visual novel, and both games - have an anime adaption, the same anime does not have to be added to both games. For - example, Da Capo has two anime adaptions - (837, 2832), - and Da Capo II as well. (5419, - 5652) But the relations for Da Capo II do not - have to be added to Da Capo and vice versa - the internal visual novel relations will - take care of that.
- After submitting a new AniDB ID, VNDB will automatically fetch information about the - anime and will present that on the site. This action can take a few minutes to - in the - worst case - hours. In that time you will see the ID of the anime, but not the title - and links to AnimeNFO and Anime News Network. It is not possible to manually add this - information, this will be fetched automatically! -
-
- - -:SUB:Staff & Cast -

It's possible to link VN entries to staff entries in the -staff and cast tabs.

-In both tabs, staff aliases can be selected by searching for their romanized or -original names. To match an exact name instead of performing a search, prefix -the name with '='. If the name is not in the database yet, you need to add it first. -

- -:SUBSUB:Staff -

- The staff tab lists the people or groups involved in the creation of the - visual novel. The following roles can be used: -

-
-
Scenario
 
-
Character design
 
-
Composer
 
-
Director
 
-
Artist
 
-
Vocals
Vocals used in the music. Not to be used for voice actors of characters, these should be listed under cast instead.
-
Staff
Used for any additional minor roles, use the "notes" field to indicate the staff's involvement.
-
-

A few guidelines:

- - -:SUBSUB:Cast -

- The cast tab lists the voice actors for each character. This tab is only - available when characters have been linked to the visual novel. -

- -:SUB:Image -

- Every visual novel should have an image, preferably one of the official cover - art of one of the releases. In some cases, especially with doujin games, if there is - no official cover art available, a general image from the game's homepage or a - screenshot of the game itself could be used instead.
- Images can be uploaded in JPEG or PNG format, and should not be larger than 5 MiB. - All images larger than 256x400px will automatically be resized to fit on the page. -

- The NSFW warning should be used in cases where the cover art is not safe for work. - To determine what is safe for work and what is not, use the following guidelines: -

- Even with these guidelines it may not always be easy to determine whether an image - is safe or not. When in doubt, it's often best to go for NSFW. -

- - -:SUB:Relations -

- Visual novel relations can be used to indicate what games are related to each - other.
- When adding a relation, the reverse relation will automatically be added to - the other visual novel. E.g. if you add game x as a sequel to game y, then game - y will automatically be added as a prequel to game x. You do not have to edit - both games.
- Only specify direct relations. If one game 1 is listed to have a relation - with game 2, and game 2 has a relation with game 3, then game 3 does not have - to be added as a relation to game 1. This may sound a bit confusing at first, - but you will understand when you look at the relation graphs. When editing relations, - always try to think about the relations between all related games - as shown in - the graph - instead of only looking at the specific visual novel you're editing. -
- The "official" checkbox can be used to indicate whether relation is an official - one or not. A relation is official if both games were published by the same - brand, or at least the publisher of the earlier game has given persmission to - create the later game. In general: fandiscs and games of the same series are - official, while fan fiction is not. -
- There is a static list of relations to choose from (as described below). As with - many things, the relations between games can in reality be more complex than these - options could describe. Simply choose the option you think is closest to describing - the actual relation when you're not sure which one to choose. -

-
-
Sequel
- Continuation of the story. <=>Prequel. -
Prequel
- The story happens before the original story.<=>Sequel. -
Same setting
- Same universe, world, reality and timeline, but completely different characters. - The definition of "setting" is not always easy to define, but usually it - means that if places or items not existing in the real world described in one - game also exist in the other game, you could use this relation. -
Alternative version
- Same setting, same characters, but the story is told differently. -
Shares characters
- Different story, but shares some characters. -
Side story
- The story takes place sometime during the parent storyline. <=>Parent story -
Parent story
- Opposite of Side story. -
Same series
- The games are part of the same series. -
Fandisc
- Fandisc. -
Original game
- The opposite of fandisc. -
-
- - -:SUB:Screenshots -Each visual novel entry can have at most 10 screenshots. Screenshots can be -uploaded in JPEG and PNG format. The uploaded screenshots are strictly -moderated to follow the guidelines listed below. It is highly recommended to -follow our instructions on creating good screenshots if you -don't want your efforts to go to waste. - - diff --git a/data/docs/3 b/data/docs/3 deleted file mode 100644 index 703d4172..00000000 --- a/data/docs/3 +++ /dev/null @@ -1,160 +0,0 @@ -:TITLE:Adding/Editing a Release -:INC:index - - -:SUB:When to add a release -

- A 'release' is a product - either physical or digital - containing (parts of) the - visual novel. This excludes soundtracks, drama CDs, fandisks, and other products - that do not contain the visual novel itself.
- All releases should be added seperately. For example, a limited and a regular edition - shouldn't be combined into one release, even if they share the release date and - contents. For commercial games, separate releases can be distinguished by their - JAN/UPC/EAN number. -

- - -:SUB:General info -
-
Type
- Is the release complete, partial or a trial version? - Complete releases have everything. - Partial releases have most of the game, but there are things still waiting - to be released. - Trial versions are heavily cut down and free releases so that you can - experience a game before you buy it. Sometimes, trial versions are cut - down for web transmission and do not completely represent the finished product.
- In the case of a translation patch, the type should indicate whether it translates - the full game (Complete), or just parts of it (Partial). -
Patch
- Use this checkbox to indicate that the release is a (translation) patch, used to - patch an other release. -
Freeware
- Check if this box if the game is downloadable (or otherwise distributed) at no cost. -
Doujin
- Published by a doujin circle, amateur group or individual, as opposed to a legal - entity such as a company. This field is ignored when the release type is set to patch. -
Title (romaji)
- The name of the release, in the Latin character set (using Romanisation or translation) -
Original title
- If the name is officially under a different title (usually because of different - character sets), put the original title here. -
Language
- What language is this release? Use the language that the majority of the game is in. -
JAN/UPC/EAN
- The GTIN code - of the product. Often called "JAN" for Japanese releases, "UPC" for USA and Canada - and "EAN" for Europe. The system will automatically detect the type from the code and - use the appropriate term on the release page. -
Catalog number
- Catalog number as assigned by the producer. Often used to identify releases on - webshops, and can usually be found somewhere on the packaging of the product. -
Official website
- URL of the official homepage for this product. Note that, even though VNDB does - not support piracy, it is allowed to link to a homepage or forum that does in the - case it is the only official source of information for this release. -
Release date
- For commercial games, the sale date. - For all others, the date on which the release was first available. - If it was posted on a website, the date on which the post was public. -
Age rating
- The minimum age rating for the release. On most releases, this is specified on the - packaging or on product web pages. -
Notes
- Anything miscellaneous and useful. - Generally, extras (but not preorder bonuses) and progress information go here. -
-
- - -:SUB:Format -
-
Resolution
- Primary/native screen resolution of the game. -
Voiced
- Indicates whether this release includes voice acting in the VN/ADV parts of the game. - Fully voiced indicates that all characters (usually excluding the protagonist - and some minor characters) are voiced in all scenes. Only ero scenes voiced - speaks for itself, and Partially voiced should be used when there is some voice - acting, but only for the main characters or only in some scenes. -
Animation
- Whether the game has any animation can be specified with two seperate options: one for - the normal story mode and one for the ero scenes, if the game has any. With Simple - animations, we refer to (usually looping) effects like falling leaves or snow in the - background or animated facial expressions like blinking eyes and a moving mouth. - Fully animated scenes refers to non-looping anime-like scenes. Some games are - entirely like this, others only have a few scenes that are fully animated. Effects like - moving sprites around the screen, basic zooming and shaking background images are not - considered as "animations". Minigames or other gameplay elements are excluded as well, - only the (ADV/VN-like) story parts and ero scenes should be considered. -
-
-

- NOTE: The resolution, voiced and animation fields have no meaning for patches, and - should be left empty for those releases. -

- Platform
- The platforms that the product was released for. Does not include emulated platforms - (e.g. Playstation 2 games on Playstation 3) or WINE. DVD Player refers to games playable - as a normal DVD Video (DVDPG) and should not be confused with the DVD as a medium. -

- Media -

-
-
Blu-ray
- Blu-ray Disk, typically 30-60GB+. Requires a Blu-ray Drive. Playstation 3 are - normally Blu-ray. -
CD
- CD-ROM, typically 700MB. -
DVD
- DVD5, typically 4.5GB, or DVD9, typically 9GB. DVDPG games are DVD. -
Floppy
- 5 1/4" or 3 3/4", no greater than 1.44MB. -
GD
- Dreamcast games are normally GD disks. -
Internet Download
- Anything without a physical box, i.e. obtained by downloading it over a network. -
Memory Card
- Any SD (Secure Digital) Card variant or MMC variant, Compact Flash or "USB Sticks". - The Main difference between this and Cartridge (below) is that Memory Cards are - re-writable (RW). -
Cartridge
- Compare with Memory Cards (above). Read-only. Famicom (NES), Super Nintendo (SNES), - Game Boy Advanced (GBA) and Nintendo DS use cartridges. -
Nintendo Optical Disk
- Non-CD or DVD optical disks used by various Nintendo consoles. -
Other
- Any format not considered to be any of these mentioned should take this media. - However, it should not be used liberally, and it's inclusion may need to be justified. -
UMD
- Universal Media Disk, typically 2.2GB. Playstation Portable uses this format. -
-
- - -:SUB:Producers -

- The companies/groups/individuals involved in the development or publishing of - this release. Does not include distributors. The following roles can be selected: -

-
Developer
- The producer involved in the creation of the game itself, not necessarily of - this specific release. Keep in mind that producers that have made modifications - to a game but have not made the game itself should NOT be listed as developers. -
Publisher
- The producer responsible for publishing this specific release. The publisher may have - made modifications to the game (e.g. translating all text or porting to a different - platform), but was not involved in the creation process. -
Both
- When the release is developed and published by the same producer. This is often - true for doujin games and the first releases of commercial games. -
-
-

- - -:SUB:Visual novel relations -

- The visual novels that this release (either partially or fully) covers. -

- diff --git a/data/docs/4 b/data/docs/4 deleted file mode 100644 index b30c32c5..00000000 --- a/data/docs/4 +++ /dev/null @@ -1,76 +0,0 @@ -:TITLE:Adding/Editing a Producer -:INC:index - - -:SUB:When to add a producer -

A producer entry may be created in one of the following scenarios:

-
    -
  1. When it is needed to link the developer or publisher to a release entry. -In this case, the producer is required to have released at least one completed -product. This means that translation projects and starting developers may only -be added when they've actually finished a project.
    2. -
  2. When it is needed to link two or more producer entries together to provide -a correct view of the relations between producers. The producer entries that -are being linked together should qualify for the first criteria, and need to be -linked to at least one release entry.
    3. -
-

Producer entries that do not qualify for either rule may be deleted after a -while.

- - -:SUB:General info -
-
Type
- The type of producer. -
Name (romaji)
- The name of the producer in the Latin alphabet, using romanisation - in case the original name isn't in the Latin alphabet already. Capitalization - is also important for this field. -
Original name
- If the Name (above) has been romanised, make sure to mention the original (most likely - the Japanese) name here. -
Aliases
- Other names the producer is known as. Multiple aliases should be separated by a newline. -
Primary language
- The language the the producer works in most of the time. By default, it is Japanese. -
Website
- Official homepage of the producer. -
Description
- A history of the producer, or a description of what type of games they make. -
-
- - -:SUB:Relations -These relations provide information about which producers are related to each -other, and how they are related. Choosing the correct relation may be a bit -confusing, check the relation graph of the producer entry in case of doubt. -The following relations are defined: -
-
Formerly
- The current producer was earlier known as the selected producer. This can be - because of a name change, or when the earlier producer disbanded and the same - people started again under a different name. -
Succeeded by
- Reverse of Formerly - selected producer was formerly known as the current producer. -
Subsidiary
- Selected producer is a subsidiary - of the current producer. -
Parent producer
- Reverse of Subsidiary - current producer is a subsidiary of the selected producer. -
Imprint
- Selected producer is an imprint of the current producer. Simply put, an - "imprint" is a different name for the same group of people, used when - publishing games. See Wikipedia for more info. -
Parent brand
- Reverse of Imprint - current producer is an imprint of the selected producer. -
Spawned
- The selected producer was formed by former members of the current producers. - The difference with the Formerly relation is that the producer where the - members came from is still alive. -
Originated from
- Reverse of Spawned - selected producer spawned the current producer. -
-
- - diff --git a/data/docs/5 b/data/docs/5 deleted file mode 100644 index 72fc58c9..00000000 --- a/data/docs/5 +++ /dev/null @@ -1,90 +0,0 @@ -:TITLE:Editing guidelines -:INC:index - - -:SUB:Romanization -

- The main audience of VNDB are the English speaking fans of visual novels. In - creating the database, we assume the intended audience can't read or recognise - anything not written in the roman script. Therefore, romanization is applied - to many fields in the database: The main title of visual novels, releases, - producers and characters should all be properly romanized if they arent in - roman script already.
- To keep the database consistent, we have decided to use a mix of Hepburn and Wapuro for all fields. This is - also consistent with AniDBs - romanization. -
- For English (or other foreign) words in a non-roman script, the original word - should be used as long as it is the intended effect. If those words are in a - non-roman script, a suitable romanisation technique should be used. -

- - -:SUB:Capitalization -

- It occasionally happens that official titles are either entirely in uppercase - or lowercase characters. If there is no real reason for this choice of - capitalization (e.g. it's not an acronym), these titles should be properly - converted to normal English capitalization (as described on Wikipedia) before - being entered in the database.
- This only applies to the main title of a visual novel entry, the 'Original - title' field and the title/name fields of other database entries (including - release entries) should use the official capitalization wherever possible. -

- - -:SUB:Name Order -

- In most English speaking countries, names are given in a "given name, family - name" order. This is called "Western Order". In English, you call someone - using their given name if you know them well, otherwise use their title and - family name. -
- In Japanese (and some other languages too), names are given in "family name, - given name" order. We call this "Japanese Order". In Japanese you can call - someone using either name with an appropriate suffix. -
- To aid English speakers, some resources (e.g. wikipedia) use Japanese names in - Western order. Here on vndb.org, we prefer to use the order that the original - game used. -
- That is, if it was originally a Japanese game with Japanese character names, - use Japanese order. -
- If the game is originally English, or a character has a completely foreign - name (Mary Smith), use Western order. -

- - -:SUB:Edit Summaries -

- Every edit to any page has a required "Edit summary" box, this allows you to - explain yourself on what your edit is about without cluttering the main page. - You can say why you've modified the description, changed a link, or show where - you obtained some information (so that other contributors can verify it). - Perhaps you want to add a visual novel to the database but are unable to find - more information for it. If you say so here, another contributor is bound to - finish it off. -

- - -:SUB:Descriptions From External Sources -

- It is possible to add a description or notes to visual novel, producer, - release and character entries in the database. While original descriptions are - preferred, using descriptions from external resources is allowed, provided the - source is properly credited. The preferred form to credit external resources - is by adding the following template to the bottom of the description:
- [From [url=URL]title or author[/url]]
- This would result in, for example, '[From Wikipedia]' for descriptions - taken from Wikipedia. If the description is not literally taken from the - source but has some modifications, the 'From' should be replaced with - something similar, indicating that it's modified, e.g. 'Edited from', 'Based - on'.
- As it is not allowed to provide links to websites providing or promoting - illegal downloads, the URL part should be left out for such descriptions. -

diff --git a/data/docs/6 b/data/docs/6 deleted file mode 100644 index 0ab93f0c..00000000 --- a/data/docs/6 +++ /dev/null @@ -1,138 +0,0 @@ -:TITLE:Frequently Asked Questions -:INC:index - - -:SUB:What is a Visual Novel? -

- A visual novel can be seen as a combination of a novel and a computer game: - they're computer games with a large text based storyline and only little - interaction of the player. A typical visual novel consists of text over - an anime-style background image and is accompanied by background music. - Throughout the game, the player usually has to answer a few questions which will - have an effect on the story, thus playing a visual novel a second time while - giving other answers may result in an entirely different plot.
-
- To get a general idea of the genre, try one of the free short visual novels - from al|together. -

- - -:SUB:How about Eroge, H-Games and Dating Sims? -

- An eroge or H-game is basically any Japanese game that features sexual - content. Many visual novels are eroge and many eroge are visual novels, - but this is not a rule. The definition of dating sim is a bit more vague, - but it's usually the same as a visual novel, except that a dating sim - generally uses a gameplay based on statistics.
-
- There are no strict bounds to the definition of "visual novel", most eroge and - dating sims include elements of visual novels, but may - strictly speaking - - not be visual novels themselves. VNDB has its own rules for inclusion in the - database, see the guidelines and the list of - special games for more information. -

- - -:SUB:Why a Visual Novel Database? -

- The internet is large, very large, but the number of English resources - related to visual novels is only very limited. VNDB attempts to collect - and present as much information as possible that would otherwise be very - hard to find for the English speaking audience. This way fans can easily - keep track of new releases and localizations of their favorite games, - while not having to browse numerous of indistinct Japanese websites. -

- - -:SUB:How can I help VNDB? -

- There are many ways to contribute to VNDB. First of all you can freely edit - all information found on this website, so if you find any errors just click - the "edit" link on the top right of the page. You can also add new information - to the database, though please search the database before you do in order to - prevent duplicate pages.
-
- To discuss about new features or to help the development of the website - itself, feel free to participate on the discussion board - or join us on IRC at #vndb @ irc.synirc.net. - If you aren't used to IRC or are just too lazy to install a client, you can - still join the chat using the Webchat. - Just choose a nickname and hit Login! -

- - -:SUB:Where can I download the Visual Novels? -

- Not here. We do not provide any links to direct downloads, torrents or - other means of downloading games. We do, however, link to the official - homepages of the producers, who may provide free trials or even full - game downloads.
-
- Our stance on piracy is that patches and downloads that have modifications to - the game's contents are allowed. This includes translation patches and - restoration patches. Any downloads, tools, cracks or codes that have the sole - purpose of avoiding the purchase of a game are considered piracy and should - not be discussed on this site. -

- - -:SUB:Can you recommend me a Visual Novel? -

- Asking for recommendations on the discussion board or on IRC is usually not a - good idea, for various reasons. If you're looking for VNs that most people - have played, check out the popularity rankings. - If you're interested in VNs that are generally considered "good" or "awesome", - check out the ratings. If you're looking for - something specific, browse through the tags. If you're - interested in a more personal answer, compare the vote lists of our users with your own and decide what to read next based on - that.
-
- If you prefer a human answer, you can also ask around at the following communities: -

- - - -:SUB:Who's that girl on the background? -

- If you don't have an account on VNDB or you've never played around with your - profile settings, then the answer you're looking for is Lasty - Farson from Angelic Serenade. If you do have an - account then you can simply go to your profile page and check which skin - you're using - the name of the skin tells you where it's from. -

- - -:SUB:I found this awesome game, but it's not available in English!? -

- Shit happens. There are several things to keep in mind: first of all, if our - database does not have a translation listed, then with a *very* high - probability it simply does not exist, anywhere. Second, we don't translate - these games ourselves and we do not coordinate the translations, either, so - asking for a translation here is rather pointless and a sure-fire way to get - your thread locked. Also, there is an order of magnitude more visual novels - than there are translators within this community. :-( -

- - -:SUB:Can I link to VNDB? -

- Of course you can! We even have some icons you could use to link to and promote - VNDB. Direct linking is, as with all other images on this site, allowed.
- - - - - - -
- If you feel these banners don't suit your needs, please don't hesitate to make - one yourself. -

diff --git a/data/docs/7 b/data/docs/7 deleted file mode 100644 index 67a74a1a..00000000 --- a/data/docs/7 +++ /dev/null @@ -1,69 +0,0 @@ -:TITLE:About us -:INC:index - - -:SUB:Goal -

- Our primary goal is building a large, comprehensive and up-to-date database for - information about all existing visual novels. VNDB aims to be a central place - to look up general information about the visual novels themselves, as well as - practical information around it, like available releases, localisations and - producers.
- Our secondary goal is to promote the wonderful medium called visual novels to - a broader audience, an audience not limited only to people who can understand - Japanese, but to anyone interested in literature, anime, manga or games, - regardless of their geographical location or cultural differences. -

- - -:SUB:Genesis -

- It all started right after yorhel finished reading - Ever17. Highly impressed by the masterpiece, several - questions came to his mind: After learning about visual novels, why did it - still take several months to find this game? Why hasn't he ever heard about it before? - How can a visual novel of that quality go by unnoticed in almost all online - anime and gaming communities? And more importantly: Are there more visual - novels like that out there?
-
- VNDB was born to answer that last question. The complete lack of any central - resource for, or even a simple list of visual novels made it very hard to - find new games or get a good overview of what was available. Having a central - and well-organized place where everyone can share their information and knowledge - about visual novels would solve this problem.
-
- After a short three weeks of hard work, the first version of VNDB saw the light - of day in September 2007. The obscurity and small fanbase around visual novels, - combined with the bare minimum of features and the rigid contribution system - in use at the time, made that the database only grew at a slow pace. But with time - more people learned about VNDB, new and advanced features were being introduced, - and in response more visitors started contributing information. The introduction - of an improved and open contribution system in February 2008 motivated even more - users to submit information, and as of September 2008 - a year after the initial - version of VNDB - the database catalogues more than 1000 visual novels and 2000 - releases, which still continues to grow in size and quality today. -

- - -:SUB:Credits -

- Code development
-

-
Yorhel
Main developer.
-
QCyph
Contributed the character filters.
-
3dB
Contributed improved user authentication code and post throttling on the discussion board.
-
SpaceRanger
Contributed the visual novel release comparison page, userlist columns to the VN list and dx.x.x link formatting.
-
morkt
Contributed the staff database and lots of other stuff.
-
flan
Contributed Open graph tags and test cases for the BBCode parser.
-
TigerShark
Contributed release icons.
-
-
- - Special users
-:MODERATORS: -
- -
- Skins -:SKINCONTRIB: -

diff --git a/data/docs/9 b/data/docs/9 deleted file mode 100644 index 8f964382..00000000 --- a/data/docs/9 +++ /dev/null @@ -1,80 +0,0 @@ -:TITLE:Discussion board -:INC:index - - -:SUB:Introduction -

- VNDB has a nicely integrated discussion board which can be used for, well, - discussions. As we're not using any popular or freely available forum software - and have instead written something by ourselves, this discussion board has a - few slight differences with the popular boards you're used to. -

- - -:SUB:Boards -

- To make sure interested people can find your post, all threads have relations - to one or more 'boards' that define what the discussion is about. This is similar - to boards on other forums, but here every item in the DB has its own board, and - it's possible to link a thread to more than one board. The following boards can be used: -

-
-
db
- VNDB Discussions. This board is for discussions about the database and the site. -
ge
- General discussions. This is a general board for threads that do not fit in - any of the other boards. -
v#
- For discussions about a particular visual novel. The board v17, for example, - is used for all threads related to v17. -
p#
- Same as v#, but for producers. -
u#
- The u# board can be used to notify a user on this site about something - he/she must see or to discuss about an edit he/she has made. This is similar - to the 'private message' feature of most sites, except it's not 'private'... -
an
- Used for site announcements. Limited to moderators. -
-
- - -:SUB:Formatting -

- The following codes can be used to format your message: -

-
-
X# or X#.#
- A 'VNDBID', as we call them. These are numbers starting with a character (d, p, r, u or v), - and are optionally followed by a period and a second number. VNDBIDs will automatically be converted - into links to the page on the website. For example, typing 'v4.4' will result in 'v4.4'. -
URL
- Any URL (without the use of the [url]-tag, see below) will be converted into a link, similar to the - VNDBIDs. Example: 'http://vndb.org/' will be formatted as 'link'. -
[url]
- The classic BBCode [url]-tag. Can only be used in the form of [url=link]link title[/url].
- E.g. '[url=/v]List of visual novels[/url] and [url=http://blicky.net/]some external website[/url]' - will be displayed as 'List of visual novels and some external website' -
[spoiler]
- The [spoiler]-tag should be used to hide information that could spoil the enjoyment of playing the - visual novel for people who haven't done so yet. -
[quote]
- When quoting other people, put the quoted message inside a [quote] .. [/quote] block. Please - note that the popular [quote=source]-syntax doesn't work on VNDB. (yet) -
[raw]
- Show off your formatting code skills by putting anything you don't want to have formatted in a [raw] - tag. Any of the formatting codes mentioned above are ignored within a [raw] .. [/raw] block. -
[code]
- Similar to [raw], except that the text within the [code] .. [/code] block is - formatted in a fixed width font and surrounded by a nice box to keep it - separate from the rest of your post. -
-
-

- There is no [img]-tag and there won't likely ever be one, if you want to include - screenshots or other images, please upload them to an external hosting service - (e.g. TinyPic) and link to them - in your post. -

- - diff --git a/data/docs/incomplete b/data/docs/incomplete deleted file mode 100644 index 61109196..00000000 --- a/data/docs/incomplete +++ /dev/null @@ -1,4 +0,0 @@ -
- The translation for this page is not synchronised with the original version. - To see the latest version, switch to the English website. -
diff --git a/data/docs/index b/data/docs/index deleted file mode 100644 index 05339b6a..00000000 --- a/data/docs/index +++ /dev/null @@ -1,19 +0,0 @@ - diff --git a/data/docs/notfinished b/data/docs/notfinished deleted file mode 100644 index 8b6b379f..00000000 --- a/data/docs/notfinished +++ /dev/null @@ -1,4 +0,0 @@ -
- This page is not yet finished!
- If you are interested in helping us finish it off, please join us on IRC. -
-- cgit v1.2.3