You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Ghostwriter uses template documents and the Jinja2 template language ([https://jinja.palletsprojects.com/en/2.11.x/](https://jinja.palletsprojects.com/en/2.11.x/)) to give you as much control over document generation as possible.
8
+
Ghostwriter uses template documents and the Jinja2 template language ([https://jinja.palletsprojects.com/en/stable/](https://jinja.palletsprojects.com/en/stable/))
9
+
to give you as much control over document generation as possible.
9
10
10
-
Learn more about managing report templates here:
11
+
Learn more about managing report templates here:[Report Templates](/features/reporting/report-templates)
You will need to upload at least one PowerPoint slide deck to use as a template. Once you have a template you can pick from, open your report and
14
+
select the template from the dropdown menu under the **Generate Reports** section. You should see a notification when the template selection is saved.
15
+
You can then click the PowerPoint icon to generate a report.
13
16
14
-
You will need to upload at least one PowerPoint slide deck to use as a template. Once you have a template you can pick from, open your report and select the template from the dropdown menu under the **Generate Reports** section. You should see a notification when the template selection is saved. You can then click the PowerPoint icon to generate a report.
15
-
16
-
Depending on the size of your report and template, rendering can take a few seconds. Once the report is done, your browser will download a new PowerPoint document.
17
+
Depending on the size of your report and template, rendering can take a few seconds. Once the report is done, your browser will download a new PowerPoint
18
+
document.
17
19
18
20
The default filename will be: `YYYYMMDD_HHMMSS_CLIENT-NAME_ASESSMENT-TYPE.pptx`
19
21
20
22
### PowerPoint Templates
21
23
22
-
There are fewer customization options for PowerPoint than Word. Your template slide deck controls how the generated slide deck looks, but the content will always be the same.
24
+
There are fewer customization options for PowerPoint than Word. Your template slide deck controls how the generated slide deck looks, but the content
25
+
will always be the same.
23
26
24
27
<Warning>
25
-
The PowerPoint template should be empty – i.e., should contain zero slides. Edit the master slides to control colors, layout, slide numbers, and other details.
28
+
The PowerPoint template should be empty – i.e., should contain zero slides. Edit the master slides to control colors, layout, slide numbers, and other
29
+
details.
26
30
27
31
To open your slide master view in PowerPoint: *View* » *Slide Master*
28
-
</Warning>
29
-
Ghostwriter will add slides to your chosen template slide deck. The new slides include placeholders and dynamic project information.
30
-
31
-
<Info>
32
-
Each slide is set to fit text to the size of the text field. This auto-resizing happens in PowerPoint's rendering engine, so a slide's text might extend beyond the slide's lower boundary when you open your new presentation.
33
-
34
-
PowerPoint should activate auto-resizing when you save the presentation or edit any text.
35
-
</Info>
36
-
***Title Slide**
37
32
38
-
* Includes your configured company name, selected project type, and client name
39
-
40
-
***Agenda Slide**
33
+
PowerPoint remembers if you closed the deck with the Slide Master view open or not and will re-open where you left off. To avoid every presentation opening
34
+
on the view, close it before saving and uploading your template.
35
+
</Warning>
41
36
42
-
* Placeholder for you to enter a meeting agenda
37
+
Your templates should include at least three slide layouts in your _Slide Master_ view. Your first layout must be your title slide layout, the second layout
38
+
must be your content layout, and your last layout must be your final/conclusion slide layout. Ghostwriter uses these three layouts, but you are welcome to
39
+
include additional layouts between the content layout and the final slide layout. Just ensure the layout for your conclusion slide is last.
43
40
44
-
***Introduction Slide**
41
+
Ghostwriter will attempt to intelligently use the placeholders you include in your layouts. The slide's title (type 1 placeholder) will go into the slide's
42
+
title placeholder. Likewise, when Ghostwriter adds a subtitle to the title slide, it will try to use a subtitle placeholder (type 4 placeholder), if present.
43
+
Finally, you want a content placeholder (type 7 placeholder) for the slide's main body.
45
44
46
-
* Placeholder for any presenter introductions
45
+
<Info>
46
+
Adding text boxes and other objects does not create placeholders. These are "shapes" that will always be present on slides created with the layout. If the
47
+
expected placeholders are not present, Ghostwriter will try to fallback to using detected shapes. If there are no shapes, the reporting engine will create
48
+
new shapes. Ghostwriter tries to make new shapes in the same position where title and content are often placed, but it's a best guess on our part.
47
49
48
-
***Methodology Slide**
50
+
Make use of placeholders for the best output!
51
+
</Info>
49
52
50
-
* Placeholder for reviewing testing methodology
53
+
Title and subtitle are special placeholders. Each slide can contain one of each. You can verify you have these placeholders in a couple of different ways.
54
+
You can see if you have a title placeholder by looking at your layout and verifying the _Title_ checkbox is checked under the _Slide Master_ section of the
55
+
ribbon menu. It's a good idea to toggle it off and on to verify the placeholder you expect to be the title is really the title. If someone manually moved
56
+
the title to repurpose it (e.g., for content or as a footer placeholder), that placeholder is still the title for that layout.
51
57
52
-
***Attack Path Overview Slide**
58
+
Subtitles are trickier because PowerPoint actually offers no way to create these from the _Insert Placeholder_ menu. There is also no checkbox to create one
59
+
like there is for _Title_ or _Footers_. Many default PowerPoint layouts include them, which is one way to get them. You can also copy and paste a subtitle placeholder from another slide. Finally, you can use a macro to insert a subtitle placeholder.
53
60
54
-
* Placeholder for where you might discuss assessment narratives
61
+
These two macros can be helpful for identifying the type of placeholder you have selected and inserting a subtitle placeholder on your title slide (for use
62
+
or copy/pasting):
55
63
56
-
***Findings Overview Slide**
64
+
```vb
65
+
SubInsertSubtitlePlaceholder()
66
+
DimoSlideMasterAsMaster
67
+
DimoLayoutAsCustomLayout
68
+
DimoSubtitleShapeAsShape
57
69
58
-
* Includes a two-column table showing all findings (full title and severity)
* All text evidence files as new text blocks 9styled with a fixed-width font)
88
+
CaseppPlaceholderTitle
89
+
MsgBox"Title Placeholder"
69
90
70
-
* Finding description as main slide content
91
+
CaseppPlaceholderCenterTitle
92
+
MsgBox"Centered Title Placeholder"
71
93
72
-
* All other finding information in the slide's notes field
94
+
CaseppPlaceholderSubtitle
95
+
MsgBox"Subtitle Placeholder"
73
96
74
-
***Observations Slide**
97
+
CaseppPlaceholderObject
98
+
MsgBox"Content Placeholder"
75
99
76
-
* Placeholder for any additional observations
100
+
EndSelect
101
+
EndIf
102
+
EndWith
103
+
EndSub
104
+
```
77
105
78
-
***Recommendations Slide**
106
+
For further reference: [PowerPoint PpPlaceholderType Enumeration](https://learn.microsoft.com/en-us/office/vba/api/powerpoint.ppplaceholdertype)
79
107
80
-
* Placeholder for any recommendations
108
+
### PowerPoint Generation
81
109
82
-
***Conclusion Slide**
110
+
Ghostwriter will add slides to your chosen template slide deck. The new slides include placeholders and dynamic project information.
83
111
84
-
* Placeholder for closing statements or next steps
112
+
<Info>
113
+
Each slide is set to fit text to the size of the text field. This auto-resizing happens in PowerPoint's rendering engine, so a slide's text might extend
114
+
beyond the slide's lower boundary when you open your new presentation.
85
115
86
-
***Final Slide**
116
+
PowerPoint should activate auto-resizing when you save the presentation or edit any text.
117
+
</Info>
87
118
88
-
* Closing title slide that includes your configured company name, social media account, and email address
119
+
| Slide Type | Description |
120
+
|------------|-------------|
121
+
| Title Slide | Includes your configured company name, selected project type, and client name |
122
+
| Agenda Slide | Placeholder for you to enter a meeting agenda |
123
+
| Introduction Slide | Placeholder for any presenter introductions |
124
+
| Methodology Slide | Placeholder for reviewing testing methodology |
125
+
| Attack Path Overview Slide | Placeholder for where you might discuss assessment narratives |
126
+
| Findings Overview Slide | Includes a two-column table showing all findings (full title and severity) |
127
+
| Findings Slides | One slide per finding that includes:<br/>• Finding title as the slide title<br/>• All image evidence files as inserted images<br/>• All text evidence files as new text blocks (styled with a fixed-width font)<br/>• Finding description as main slide content<br/>• All other finding information in the slide's notes field |
128
+
| Observations Slide | Placeholder for any additional observations |
129
+
| Recommendations Slide | Placeholder for any recommendations |
130
+
| Conclusion Slide | Placeholder for closing statements or next steps |
131
+
| Final Slide | Closing title slide that includes your configured company name, social media account, and email address |
0 commit comments