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

From Path of Diablo Wiki
Jump to: navigation, search
(Class skill pages)
(The skill descriptions)
Line 63: Line 63:
 
=== The skill descriptions ===
 
=== The skill descriptions ===
  
Using  [[Fire_Spells#Fire_Wall|Fire Wall]]  as an example, the existing skill descriptions look like this:
+
Using  [[Fire_Spells#Fire_Wall|Fire Wall]]  as an example, the skill description looks like this:
  
'''Description:''' Creates a wall of flame that blocks of burns your enemies.
 
 
'''Required Level:''' 18
 
 
'''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 100: Line 78:
 
|
 
|
  
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]] }}  
{| <!-- 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'''
 
|-
 
|'''Required Level:''' 18
 
|-
 
|'''Prerequisites:'''  [[Fire_Spells#Blaze|Blaze]], [[Fire_Spells#Immolate|Immolate]]  
 
|}
 
|-
 
|</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:  
+
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
+
*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 skill description
+
*The narrative skill description
 
*The level required for the skill
 
*The level required for the skill
*Any prerequisites required
+
*Any prerequisites required (these links also need to be surrounded by double brackets)
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:
 
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.
 
 
 
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 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.]]
 
  
Here's a short video about editing a skill description.
+
All skill icons can be found here on the wiki: [[Special:UncategorizedFiles]].
<youtube>https://youtu.be/M9hSpJGWgL8</youtube>
 
  
 +
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  ===
 
=== Synergies and static values  ===

Revision as of 22:24, 20 September 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

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

  • The format for this can be found on Sacrifice
    • It's one static table on the left, and one longer table with scroll bar on the right
  • Possibly better table put in place on Javelin & Spear and Passive & Magic trees

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" |
|
|}
|}