Module:Libyan Civil War detailed map/doc: Difference between revisions

Revision as of 22:31, 19 December 2017

Revision as of 21:03, 14 January 2018

Line 1:

[[Template:Libyan Civil War detailed map]]

== Contested icon ==

===Definition===

The purpose of the contested icon ([[File:80x80-grey-black-anim.gif|11px]]) is to show 2 groups of soldiers fighting over control of a town, and that there is a significant number of troops ''inside'' the city actively holding territory. We generally turn a town contested based on ''widespread'' clashes reports. Contested means we cannot say one specific side controls the town. There should be evidence that the enemy is ''inside'' the town, which is a necessary (but not sufficient) condition for making a town contested. Contested status is appropriate if the town in question is controlled partly by one party, and partly by another. For example, it could be that one party controls the outer neighborhoods, while the other party holds the city center.

===Examples of cases where the contested icon should ''not'' be used===

* A case where there was no chance of the enemy taking the town over, and only, small clashes were going on in the town. We don´t put towns contested if there are only sporadic clashes. So reports of clashes are not always enough to mark a town as contested.

* A case where there were clashes in a town with a handful of enemy fighters and the clashes were over after some hours. For example if source says: "… at least six insurgents were killed during the clashes … while the rest of militants escaped on Saturday evening”

* A case where there was just one source about clashes in a major town and what occurred was essentially a small firefight. Sleeper cells infiltrated the town and shot at some soldiers, and the soldiers shot back and killed some of them. The source then reports the rest of the fighters as having fled the battlefield. So this was a one-off, hit-and-run attack, not a serious attempt to grab and ''hold'' parts of the town.

* A case where there were many separate reports of rebel ambushes on army checkpoints so this was not a ''seizure of territory'' inside of the town. The rebels do not control any part of the town, so a contested icon is unwarranted.

* A case where the enemy reached city limits. Well, they still haven't entered the city proper (which is the prerequisite for marking the city as "contested") When the city really becomes contested, a bunch of news outlets will be reporting on it. Just because there is enemy at gates does not mean it is contested. The enemy needs to be making progress in the city.

* The evidence should be especially strong to turn a “stronghold” contested. A few clashes, especially on the periphery are not enough. There should be evidence that the enemy can do more than just hit & run attacks. In these cases, a semi-circle is often enough.

===Cities===

[[File:Largecitycontested.png|thumb|250px|right]]The larger the size of the town, the more evidence is needed to make it contested. This is even more so the case for cities. Large cities (such as province capitals) are almost never marked as contested. Instead we make image mini-maps for them or put small icons on them to represent neighborhoods that are contested or controlled by a specific party. In contrast, a simple clash report of a small unknown village can turn it contested.

'''For example''', we would not mark as contested a city where a party still controls 95% of the city. Instead we mark specific enemy positions on the outskirts of the city until fighting in the city becomes widespread. As nobody claims there is any fighting inside of the city, it should be marked as colored dot within a siege circle (see Figure 1). Then, advanced points in the city should be marked as small dots in the color of the enemy (or small contested icons). In this specific case, a "contested" icon was added to represent the "west side of the city" that is contested (see Figure 2). This is more informative to our viewers. Since the code puts icons on the map in the order of code lines (starting with first line of code and ending with last line of code), the small "contested" icon should come in the line ''after'' that of the (large) city icon. Otherwise, the small icon will be hidden by the large icon and will therefore be invisible.

After the fights become more widespread in the city (& enemy controls a larger part of the city), we can remove the "west side of the city" icon and turn the whole city contested (see Figure 3). After this, if we learn that the enemy has taken over the whole city except for a small pocket (in south east) that is still resisting, then we change the contested icon into the color of the enemy and put a small dot representing the small pocket that is still resisting (see Figure 4).

== Siege and pressure from one side icons ==

===Definition===

The siege icon ([[File:map-circle-black.svg|12px]]) should be used for towns that are under siege or strong enemy pressure. The “pressure from one side” icon ([[File:map-arcNE-black.svg|11px]]) should be used for towns that are under enemy pressure from one side.

===How to place these icons===

The easiest way to place these icons is to copy/paste the line code of the object you want to have a circle (or semi-circle) around it and then:

# Replace the mark = parameter with [[File:map-circle-black.svg|12px]] or [[File:map-arcNE-black.svg|11px]]

# Increase marksize = parameter by 4. So for example, if the town dot has a size of 10, then the circle (or semi-circle) should have a size of 14.

Always put line of code circle (or semi-circle) ''before'' line of code of town (or other object). This is because the code puts icons on the map in the order of code lines starting with first line of code and ending with last line of code. If you put the line of code that draws the circle (or semi-circle) icon ''after'' the line of code that draws the town icon then the computer puts the town icon first and then put the circle (or semi-circle) icon on top of it. The town icon still appears because the circle (or semi-circle) is drawn on a transparent background. However, even a transparent background does obstruct the name of the town icon from appearing. So, the name of the town will not appear when you hold cursor over it.

'''Example:'''

* Correct: <syntaxhighlight lang="lua">{ lat = "33.972", long = "36.897", mark = "map-arcNE-black.svg", marksize = "12" },

{ lat = "33.972", long = "36.897", mark = "Abm-red+icon.png", marksize = "8", label = "Brigade 128", label_size = "0" },</syntaxhighlight>

* Wrong: <syntaxhighlight lang="lua">{ lat = "33.972", long = "36.897", mark = "Abm-red+icon.png", marksize = "8", label = "Brigade 128", label_size = "0" },

{ lat = "33.972", long = "36.897", mark = "map-arcNE-black.svg", marksize = "8" },</syntaxhighlight>

==Labels==

''Only'' towns & border posts can have blue visible wikilink labels. Whether a town has a blue visible wikilink label or not will depend on its size, importance and available space around it for the label to appear without obstructing other towns.

=="link=" parameter: linking towns to sources==

Line 39 ⟶ 78:

Step 2: In the map code, we need to update the link parameter to point to the new status in the new article. [https://en.wikipedia.org/w/index.php?title=Module:Syrian_Civil_War_detailed_map&diff=799666773&oldid=799624578 This edit] does this. As you can see, the link was changed from link="[[Deir ez-Zor offensive (April–July 2014)#Kabajeb]]" to link="[[Central Syria campaign (July 2017–present)#Kabajeb]]". However, for this to work, we need to also put the expression <nowiki>{{anchor|Kabajeb}}</nowiki> at the beginning of the part in the new article that talks about the new status. This is done in [https://en.wikipedia.org/w/index.php?title=Central_Syria_campaign_(July_2017%E2%80%93present)&diff=799653245&oldid=799649953 this edit].

'''Example 3: For another illustration on how the link= parameter and "anchor" template work, see [[Talk:Cities and towns during the Syrian Civil War/Archive 65#Link of Suran, Hama]].'''

==How to preview map before saving edit==