Difference between revisions of "Path of Diablo Wiki talk:About"

From Path of Diablo Wiki
Jump to: navigation, search
(Duration tables)
 
(14 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
== Wiki To-Do ==
 
== Wiki To-Do ==
 
This page is meant to house a "to-do" list, in progress, and wish list for edits to the PoD Wiki
 
This page is meant to house a "to-do" list, in progress, and wish list for edits to the PoD Wiki
 
This page is NOT linked to anywhere
 
  
 
== Wiki editing documentation ==
 
== Wiki editing documentation ==
Line 15: Line 13:
  
 
Difficult to explain (and display!) in just text here, probably need good written documentation AND a video tutorial
 
Difficult to explain (and display!) in just text here, probably need good written documentation AND a video tutorial
 +
 +
 +
== Duration tables ==
 +
Where duration is "X plus Y seconds per level", add those numbers to damage tables. Some skills already have this, but some do not.
 +
Amazon, Assassin, and Barb skills are done. Necro skills are done except for Curses.
  
 
== Bugs ==
 
== Bugs ==
Is a known bugs page helpful and needed? Or is it enough to list known bugs with skills that have them?
+
Is a known bugs page helpful and needed? Or is it enough to list known bugs along with the skills that have them?
  
 
This would only really have 3 skills listed I think? Not sure an entire page dedicated to that is worth it.  
 
This would only really have 3 skills listed I think? Not sure an entire page dedicated to that is worth it.  
Line 25: Line 28:
 
== Class skill pages ==
 
== Class skill pages ==
 
Transition all class skills to the new display template/layout:
 
Transition all class skills to the new display template/layout:
* Sorc, Druid, Paladin are all incomplete but in progress
+
* Druid, Paladin are all incomplete but in progress
* Amazon, Assassin, Necromancer, Barbarian have been adjusted for the new look
+
* Amazon, Assassin, Necromancer, Barbarian, Sorc have been adjusted for the new look
 
** '''Would be good for fresh eyes to look at it'''
 
** '''Would be good for fresh eyes to look at it'''
* A few skills are missing display icons
+
* A few skills are missing display icons ([[Combat_Masteries#Pulverize|Pulverize]] and a couple of the [[Item-only_Skills|Item-only Skills]]; likely does not matter, but the lack of an icon stands out)
  
 
Go back through and change damage tables in skill pages to reflect up to lvl 40
 
Go back through and change damage tables in skill pages to reflect up to lvl 40
* The format for this can be found on  [[Paladin_Combat_Skills#Sacrifice|'''Sacrifice''']]
+
*Druid and Paladin needs finishing
** It's one static table on the left, and one longer table with scroll bar on the right
 
  
 
== Aggregated class change page ==
 
== Aggregated class change page ==
Line 44: Line 46:
 
== Armor vs Armo'''u'''r ==
 
== Armor vs Armo'''u'''r ==
 
Shiver Armo/ur is spelled both ways in various places throughout the wiki, should be "Armor" with no U. Find and fix.
 
Shiver Armo/ur is spelled both ways in various places throughout the wiki, should be "Armor" with no U. Find and fix.
 +
 +
<span style="color: red"> '''Update:''' </span>Looks like '''Armor''' is the winner; this section will be deleted when that's complete.
  
 
== Nit picking ==
 
== Nit picking ==
 
*Skill descriptions, do they all not end with a period? Are they statements or sentences?
 
*Skill descriptions, do they all not end with a period? Are they statements or sentences?
 
**Same for patch notes listed in skill pages
 
**Same for patch notes listed in skill pages
*Are all prerequisite skill listed in not bold?
+
*Are all prerequisite skill listed in '''not''' bold?
 
*Are all Skill-based synergies in bold?
 
*Are all Skill-based synergies in bold?
 
*Are all attribute-based synergies (i.e. Dexterity or Intelligence) not in bold?
 
*Are all attribute-based synergies (i.e. Dexterity or Intelligence) not in bold?
 
*Is spacing between sections on pages standard? Like, no extra white space?
 
*Is spacing between sections on pages standard? Like, no extra white space?
 
  
 
== Wiki Editing ==
 
== Wiki Editing ==
 
This section will provide a brief intro to editing the PoD wiki, with a focus on the formatting of skills.
 
This section will provide a brief intro to editing the PoD wiki, with a focus on the formatting of skills.
  
=== The skill descriptions ===
+
For these examples, we'll be using [[Fire_Spells#Fire_Wall|Fire Wall]].
  
Using  [[Fire_Spells#Fire_Wall|Fire Wall]]  as an example, the existing skill descriptions look like this:
+
https://i.imgur.com/oDmwUwu.png
  
'''Description:''' Creates a wall of flame that blocks of burns your enemies.
+
=== The skill descriptions ===
  
'''Required Level:''' 18
+
Using  [[Fire_Spells#Fire_Wall|Fire Wall]]  as an example, the skill description looks like this:
  
'''Prerequisites:''' Blaze, Immolate
 
 
This is the code makes it appear like that:
 
<pre>
 
'''Description:''' Creates a wall of flame that blocks of burns your enemies.
 
 
'''Required Level:''' 18
 
 
'''Prerequisites:''' Blaze, Immolate
 
</pre>
 
 
''You'll notice that the words in '''bold''' have three single quotes (<nowiki>'''</nowiki>) surrounding them, this is the code formatting that makes characters bold in the wiki. ''
 
 
The modern standard for skill is to include a picture of the skill icon and clickable links in the list of prerequisites.
 
Still picking on [[Fire_Spells#Fire_Wall|Fire Wall]], the end product should look like this:
 
 
<!-- If skill doesnt exist in original Diablo 2 remove comment marks below -->
 
<!-- <span style="color:green">'''New skill'''</span>  -->
 
 
{|
 
{|
 
|-
 
|-
 
|
 
|
 
{| <!-- Description table -->
 
{| <!-- Description table -->
|rowspan="3" style="vertical-align:top; padding:0.5em 0.5em 0.5em 0.5em; width:5%"|https://pathofdiablo.com/wiki/images/sorceress/Fire%20Wall.png ||'''Description:''' Creates a wall of flame that blocks of burns your enemies'''
+
|rowspan="3" style="vertical-align:top; padding:0.5em 0.5em 0.5em 0.5em; width:5%"|[[File:Fire_Wall.png]]  ||'''Description:''' Creates a wall of flame that blocks of burns your enemies'''
 
|-
 
|-
 
|'''Required Level:''' 18
 
|'''Required Level:''' 18
Line 96: Line 81:
 
|
 
|
  
The code to make this happen is a lot longer than the code to make the original happen, and it looks like this:
+
The new standard for skill descriptions is to include a picture of the skill icon and clickable links in the list of prerequisites. To simplify the editing process we've created a wiki template to remove the need to worry about formatting and spacing, and all you need to do is add a link to the skills icon, the narrative description, the level required, and any comma separated prerequisites. The template is named Skilldesc, and you can use it by issuing <nowiki> {{ Skilldesc | icon | description | level required | prerequisites }} </nowiki>.
<pre>
+
Filling this in with the information for Fire Wall it would look like this:
{|
+
<pre> {{ Skilldesc | [[File:Fire_Wall.png]] | Creates a wall of flame that blocks of burns your enemies | 18 | [[Fire_Spells#Blaze|Blaze]] , [[Fire_Spells#Immolate|Immolate]]  }} </pre>
 +
And this creates:
 +
{{ Skilldesc | [[File:Fire_Wall.png]] | Creates a wall of flame that blocks of burns your enemies | 18 | [[Fire_Spells#Blaze|Blaze]] , [[Fire_Spells#Immolate|Immolate]]  }}
 +
 
 +
 
 +
In that template, we have 4 pieces of information that will vary from skill to skill and need to be edited to reflect the skill:
 +
*The skill icon (note the link needs to be surrounded by double brackets and include the "File:" in the link, ex: <nowiki>[[File:Fire_Wall.png]] </nowiki>)
 +
*The narrative skill description
 +
*The level required for the skill
 +
*Any prerequisites required (these links also need to be surrounded by double brackets)
 +
 
 +
All skill icons can be found here on the wiki: [[Special:UncategorizedFiles]].
 +
 
 +
For skill prerequisites (and synergy tables), the standard is for clickable links to the skills. For [[Fire_Spells#Fire_Wall|Fire Wall]] to get [[Fire_Spells#Blaze|Blaze]] and [[Fire_Spells#Immolate|Immolate]] as clickable links instead of just text, we'll be using the <nowiki>[[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]]</nowiki> skill links in the code. To find copy/pasteable links to skills, navigate to the [[Main_Page | home page of the wiki]] and click on the relevant class link under the '''Character Attributes''' heading, and then click that classes Discussion tab. There, you'll see all that classes skills listed along with links that you can copy and paste. For this example we've been looking at sorceress skills, [[Talk:Sorceress|links for which can be found here.]]
 +
 
 +
=== Synergies and static values  ===
 +
 
 +
After the skill description, the next part we'll focus on are the synergies and miscellaneous static values a skill has. For Fire Wall, the relevant parts are highlighted below:
 +
 
 +
https://i.imgur.com/XABVvf4.png
 +
 
 +
We want these in their own tables, side by side like this:
 +
 
 +
{| style="margin:auto 0em;" <!-- Layout table for description and misc tables-->
 
|-
 
|-
 +
| style="vertical-align:top;" |
 +
{| class="wikitable" <!-- Additional skill table (put here not scalable skill properties) -->
 +
|- style="text-align:left;"
 +
| Fire Duration: || 3.6 seconds
 +
|- style="text-align:left;"
 +
| Cooldown: || 1.4 seconds
 +
|}
 +
| style="width:20px" |
 
|
 
|
{| <!-- Description table -->
+
{| class="wikitable" <!-- Synergies table (Please use skill codes from class discussion page) -->
|rowspan="3" style="vertical-align:top; padding:0.5em 0.5em 0.5em 0.5em; width:5%"|https://pathofdiablo.com/wiki/images/sorceress/Fire%20Wall.png ||'''Description:''' Creates a wall of flame that blocks of burns your enemies'''
+
! Synergies !! Bonus to skill
 +
|-style="text-align:left;"
 +
|     [[Fire_Spells#Warmth|'''Warmth''']]
 +
| +4% Fire damage per hardpoint
 +
|-style="text-align:left;"
 +
|    [[Fire_Spells#Blaze|'''Blaze''']]
 +
| +4% Fire damage per hardpoint
 
|-
 
|-
|'''Required Level:''' 18
+
| style="text-align:left;" colspan="2;" |    [[Fire_Spells#Fire_Mastery|'''Fire Mastery''']]
|-
+
|}
|'''Prerequisites:'''  [[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]]
+
| style="width:20px" |
 +
|
 
|}
 
|}
|-
 
|</pre>
 
  
In that example, we have 4 pieces of information that will vary from skill to skill and need to be edited to reflect the skill:
 
*The skill icon
 
*The skill description
 
*The level required for the skill
 
*Any prerequisites required
 
The labels for Description, Required Level, and Prerequisites are all in bold.
 
  
The most obvious changes are the skills picture/icon and the clickable links in the prereq's list. All icons can be found here:
+
And this is the code that gets us there:
https://pathofdiablo.com/wiki/images/
 
  
In there you'll see a folder for every class, and all skill icons for that classes skills can be found in its folder. Adding the link to the [[Fire_Spells#Fire_Wall|Fire Wall]] icon includes the picture in the description. You'll see a "pipe" <nowiki>|</nowiki> character before the icon link and a double pipe ( <nowiki>||</nowiki> ) after it, as well as in various other places in the code. These pipes help control placement and formatting of text throughout the wiki pages and are necessary to make it appear the way it's supposed to.
+
<pre>
 +
{| style="margin:auto 0em;" <!-- Layout table for description and misc tables-->
 +
|-
 +
| style="vertical-align:top;" |
 +
{| class="wikitable" <!-- Additional skill table (put here not scalable skill properties) -->
 +
|- style="text-align:left;"
 +
| Fire Duration: || 3.6 seconds
 +
|- style="text-align:left;"
 +
| Cooldown: || 1.4 seconds
 +
|}
 +
| style="width:20px" |
 +
|
 +
{| class="wikitable" <!-- Synergies table (Please use skill codes from class discussion page) -->
 +
! Synergies !! Bonus to skill
 +
|-style="text-align:left;"
 +
|    [[Fire_Spells#Warmth|'''Warmth''']]
 +
| +4% Fire damage per hardpoint
 +
|-style="text-align:left;"
 +
|    [[Fire_Spells#Blaze|'''Blaze''']]  
 +
| +4% Fire damage per hardpoint
 +
|-
 +
| style="text-align:left;" colspan="2;" |    [[Fire_Spells#Fire_Mastery|'''Fire Mastery''']]
 +
|}
 +
| style="width:20px" |
 +
|
 +
|}
 +
|}
 +
</pre>
  
The narrative skill description and level required are self explanatory, and generally I just copy the existing description from the old display into the new display.
+
For skills that have no synergies, we've created two templates named Skilldescnosynergiesleft and Skilldescnosynergiesright. You can use these templates by simply issuing <nowiki> {{Skilldescnosynergiesleft}} or {{Skilldescnosynergiesright}}</nowiki>. This results in:
 
+
{|
For skill prerequisites, the standard is for clickable links to the skills. For [[Fire_Spells#Fire_Wall|Fire Wall]] to get [[Fire_Spells#Blaze|Blaze]] and [[Fire_Spells#Immolate|Immolate]] as clickable links instead of just text, we'll be using the <nowiki>[[Fire_Spells#Blaze|Blaze]],  [[Fire_Spells#Immolate|Immolate]]</nowiki> skill links in the code. To find copy/pasteable links to skills, navigate to the [[Main_Page | home page of the wiki]] and click on the relevant class link under the '''Character Attributes''' heading, and then click that classes Discussion tab. There, you'll see all that classes skills listed along with links that you can copy and paste. For this example we've been looking at sorceress skills, [[Talk:Sorceress|links for which can be found here.]]
+
{|
 
+
{{Skilldescnosynergiesleft}} {{Skilldescnosynergiesright}}
Here's a short video about editing a skill description.
 
<youtube>https://youtu.be/M9hSpJGWgL8</youtube>
 

Latest revision as of 04:24, 6 October 2023

Welcome to the PoD Wiki

Anyone can login to their PoD account and edit the pages of this wiki. So please; if you see outdated or missing information, help us fix it. Thanks!

Wiki To-Do

This page is meant to house a "to-do" list, in progress, and wish list for edits to the PoD Wiki

Wiki editing documentation

Create a "how to" for wiki editing

Started right here on this page.

Difficult to explain (and display!) in just text here, probably need good written documentation AND a video tutorial


Duration tables

Where duration is "X plus Y seconds per level", add those numbers to damage tables. Some skills already have this, but some do not. Amazon, Assassin, and Barb skills are done. Necro skills are done except for Curses.

Bugs

Is a known bugs page helpful and needed? Or is it enough to list known bugs along with the skills that have them?

This would only really have 3 skills listed I think? Not sure an entire page dedicated to that is worth it.

Who would have the capacity and bandwidth to maintain it?

Class skill pages

Transition all class skills to the new display template/layout:

  • Druid, Paladin are all incomplete but in progress
  • Amazon, Assassin, Necromancer, Barbarian, Sorc have been adjusted for the new look
    • Would be good for fresh eyes to look at it
  • A few skills are missing display icons (Pulverize and a couple of the Item-only Skills; likely does not matter, but the lack of an icon stands out)

Go back through and change damage tables in skill pages to reflect up to lvl 40

  • Druid and Paladin needs finishing

Aggregated class change page

This page has a lot of potential, should it be maintained?

Item only skills

Item-only skills page...

Page looks funny after converting these to the new look since they don't have the standard info

Armor vs Armour

Shiver Armo/ur is spelled both ways in various places throughout the wiki, should be "Armor" with no U. Find and fix.

Update: Looks like Armor is the winner; this section will be deleted when that's complete.

Nit picking

  • Skill descriptions, do they all not end with a period? Are they statements or sentences?
    • Same for patch notes listed in skill pages
  • Are all prerequisite skill listed in not bold?
  • Are all Skill-based synergies in bold?
  • Are all attribute-based synergies (i.e. Dexterity or Intelligence) not in bold?
  • Is spacing between sections on pages standard? Like, no extra white space?

Wiki Editing

This section will provide a brief intro to editing the PoD wiki, with a focus on the formatting of skills.

For these examples, we'll be using Fire Wall.

oDmwUwu.png

The skill descriptions

Using Fire Wall as an example, the skill description looks like this:

Fire Wall.png Description: Creates a wall of flame that blocks of burns your enemies
Required Level: 18
Prerequisites: Blaze, Immolate

The new standard for skill descriptions is to include a picture of the skill icon and clickable links in the list of prerequisites. To simplify the editing process we've created a wiki template to remove the need to worry about formatting and spacing, and all you need to do is add a link to the skills icon, the narrative description, the level required, and any comma separated prerequisites. The template is named Skilldesc, and you can use it by issuing {{ Skilldesc | icon | description | level required | prerequisites }} . Filling this in with the information for Fire Wall it would look like this:

 {{ Skilldesc | [[File:Fire_Wall.png]] | Creates a wall of flame that blocks of burns your enemies | 18 | [[Fire_Spells#Blaze|Blaze]] , [[Fire_Spells#Immolate|Immolate]]  }} 

And this creates:

Fire Wall.png Description: Creates a wall of flame that blocks of burns your enemies
Required Level: 18
Prerequisites: Blaze , Immolate


In that template, we have 4 pieces of information that will vary from skill to skill and need to be edited to reflect the skill:

  • The skill icon (note the link needs to be surrounded by double brackets and include the "File:" in the link, ex: [[File:Fire_Wall.png]] )
  • The narrative skill description
  • The level required for the skill
  • Any prerequisites required (these links also need to be surrounded by double brackets)

All skill icons can be found here on the wiki: Special:UncategorizedFiles.

For skill prerequisites (and synergy tables), the standard is for clickable links to the skills. For Fire Wall to get Blaze and Immolate as clickable links instead of just text, we'll be using the [[Fire_Spells#Blaze|Blaze]], [[Fire_Spells#Immolate|Immolate]] skill links in the code. To find copy/pasteable links to skills, navigate to the home page of the wiki and click on the relevant class link under the Character Attributes heading, and then click that classes Discussion tab. There, you'll see all that classes skills listed along with links that you can copy and paste. For this example we've been looking at sorceress skills, links for which can be found here.

Synergies and static values

After the skill description, the next part we'll focus on are the synergies and miscellaneous static values a skill has. For Fire Wall, the relevant parts are highlighted below:

XABVvf4.png

We want these in their own tables, side by side like this:

Fire Duration: 3.6 seconds
Cooldown: 1.4 seconds
Synergies Bonus to skill
Warmth +4% Fire damage per hardpoint
Blaze +4% Fire damage per hardpoint
Fire Mastery


And this is the code that gets us there:

{| style="margin:auto 0em;" <!-- Layout table for description and misc tables-->
|-
| style="vertical-align:top;" |
{| class="wikitable" <!-- Additional skill table (put here not scalable skill properties) -->
|- style="text-align:left;"
| Fire Duration: || 3.6 seconds 
|- style="text-align:left;"
| Cooldown: || 1.4 seconds 
|}
| style="width:20px" |
|
{| class="wikitable" <!-- Synergies table (Please use skill codes from class discussion page) -->
! Synergies !! Bonus to skill
|-style="text-align:left;"
|     [[Fire_Spells#Warmth|'''Warmth''']] 
| +4% Fire damage per hardpoint
|-style="text-align:left;"
|     [[Fire_Spells#Blaze|'''Blaze''']] 
| +4% Fire damage per hardpoint
|-
| style="text-align:left;" colspan="2;" |    [[Fire_Spells#Fire_Mastery|'''Fire Mastery''']] 
|}
| style="width:20px" |
|
|}
|}

For skills that have no synergies, we've created two templates named Skilldescnosynergiesleft and Skilldescnosynergiesright. You can use these templates by simply issuing {{Skilldescnosynergiesleft}} or {{Skilldescnosynergiesright}}. This results in:

Synergies Bonus to skill
None -
Synergies Bonus to skill
None -