ewancroft.uk
+109
.github/ISSUE_TEMPLATE/conversion_issue.md
+109
.github/ISSUE_TEMPLATE/conversion_issue.md
···
1
+
---
2
+
name: Conversion Issue
3
+
about: Report problems with WhiteWind to Leaflet conversion output
4
+
title: '[CONVERSION] '
5
+
labels: 'conversion'
6
+
assignees: ''
7
+
8
+
---
9
+
10
+
## 🔄 Conversion Problem
11
+
**What aspect of the conversion isn't working correctly?**
12
+
- [ ] Markdown parsing (headers, links, formatting, etc.)
13
+
- [ ] Rich text facets (bold, italic, code, links)
14
+
- [ ] Image/blob URL conversion
15
+
- [ ] Publication metadata
16
+
- [ ] Document structure
17
+
- [ ] JSON output format
18
+
- [ ] Other: _______________
19
+
20
+
## 📝 Input Data
21
+
**WhiteWind JSON that's causing issues:**
22
+
23
+
<details>
24
+
<summary>Click to expand WhiteWind JSON sample</summary>
25
+
26
+
```json
27
+
{
28
+
"paste": "your WhiteWind JSON here"
29
+
}
30
+
```
31
+
32
+
</details>
33
+
34
+
## 📄 Expected Output
35
+
**What should the Leaflet output look like?**
36
+
37
+
<details>
38
+
<summary>Click to expand expected Leaflet JSON</summary>
39
+
40
+
```json
41
+
{
42
+
"expected": "Leaflet format here"
43
+
}
44
+
```
45
+
46
+
</details>
47
+
48
+
## ❌ Actual Output
49
+
**What does the converter actually produce?**
50
+
51
+
<details>
52
+
<summary>Click to expand actual output</summary>
53
+
54
+
```json
55
+
{
56
+
"actual": "what the converter outputs"
57
+
}
58
+
```
59
+
60
+
</details>
61
+
62
+
## 🎯 Specific Issues
63
+
**What specifically is wrong with the conversion?**
64
+
- [ ] Content is missing
65
+
- [ ] Formatting is incorrect
66
+
- [ ] Links don't work properly
67
+
- [ ] Images aren't converted correctly
68
+
- [ ] Block types are wrong (e.g. header becomes text)
69
+
- [ ] Rich text facets are missing or incorrect
70
+
- [ ] AT-URI conversion failed
71
+
- [ ] Schema validation errors
72
+
- [ ] Other: _______________
73
+
74
+
## 📊 Impact
75
+
**How does this affect the final Leaflet publication?**
76
+
- [ ] Publication won't import into PDS
77
+
- [ ] Content displays incorrectly in Leaflet
78
+
- [ ] Links are broken
79
+
- [ ] Images don't load
80
+
- [ ] Formatting is lost
81
+
- [ ] Other: _______________
82
+
83
+
## 🔧 Workaround
84
+
**Have you found any temporary workarounds?**
85
+
Describe any manual fixes or workarounds you've used.
86
+
87
+
## 📋 Publication Settings
88
+
**What publication settings were you using?**
89
+
- Publication Name:
90
+
- Base Path:
91
+
- Theme Colors:
92
+
- Show in Discover:
93
+
- Enable Comments:
94
+
95
+
## 🌐 Environment
96
+
- **Browser:** [e.g. Chrome 120, Firefox 121, Safari 17]
97
+
- **OS:** [e.g. Windows 11, macOS 14, Ubuntu 22.04]
98
+
99
+
## 🔗 Related Documentation
100
+
**Links to relevant documentation:**
101
+
- WhiteWind schema:
102
+
- Leaflet schema:
103
+
- AT Protocol docs:
104
+
105
+
## ✔️ Checklist
106
+
- [ ] I have provided the actual WhiteWind JSON causing issues
107
+
- [ ] I have described what the output should look like
108
+
- [ ] I have tested this with minimal data to isolate the issue
109
+
- [ ] I have checked that this isn't a known limitation mentioned in the README