Assist Converting Documents into MediaWiki Format - Revision history

Anw: Minor update

2026-02-20T11:02:53Z

Minor update

← Older revision		Revision as of 13:02, 20 February 2026
Line 29:		Line 29:

	== Manual Process ==		== Manual Process ==
	The Visual Editor will convert documents safely and reasonably in most cases, with the exception of images. For image-heavy documents, the process below is recommended.		The Visual Editor will convert documents safely and reasonably in most cases, with the exception of images. For very long or image-heavy documents, the process below is recommended.

	For manual conversion:		For manual conversion:
Line 41:		Line 41:
	*** Enter a title - follow the guidelines shown.		*** Enter a title - follow the guidelines shown.
	*** Click the button - the page will be started for you with the appropriate templates (headers, footers, etc) all created for you and with sample headings ready to be entered.		*** Click the button - the page will be started for you with the appropriate templates (headers, footers, etc) all created for you and with sample headings ready to be entered.
			*** {{Note}}Word automatically converts quotes and hyphens to "smart" quotes and dashes. These do not print well in PDF. You should consider using Find/Replace to remove/replace these.
	* For each image in the document		* For each image in the document
	** see if there is an appropriate image for that screen that you can already use search for pages on that screen and reuse if you can		** see if there is an appropriate image for that screen that you can already use search for pages on that screen and reuse if you can

Anw: Added manual process

2026-02-20T11:00:31Z

Added manual process

← Older revision		Revision as of 13:00, 20 February 2026
Line 27:		Line 27:

	* https://www.vertopal.com/en/convert/docx-to-wiki-mediawiki		* https://www.vertopal.com/en/convert/docx-to-wiki-mediawiki

			== Manual Process ==
			The Visual Editor will convert documents safely and reasonably in most cases, with the exception of images. For image-heavy documents, the process below is recommended.

			For manual conversion:

			* You must be logged in.
			* Copy the appropriate text from your document.
			* Create a new page
			** For a blank page, easiest is to search for the title of the page you want to create in the Search bar, then click the red link to create the new page.
			** For a particular document type or template, use the templates provided on [[Help:CreateNewPage\|Create a new page]] from the home page. See the guides for this, but simply put:
			*** Find the document type you want to create in the list
			*** Enter a title - follow the guidelines shown.
			*** Click the button - the page will be started for you with the appropriate templates (headers, footers, etc) all created for you and with sample headings ready to be entered.
			* For each image in the document
			** see if there is an appropriate image for that screen that you can already use search for pages on that screen and reuse if you can
			** If not, copy the image, then paste into the Visual Editor. See the user guide for more details on this process, but simply put
			*** Upload the file
			*** Name the file appropriately so it can be found later - say, after the document, or the screen being documented.
			*** Make it a basic image, no larger than 800px.
			*** You can centre using the Paragraph drop-down in the toolbar.
			* Categorize your page - see the user guide for more details, but simply:
			** Choose Categories from the hamburger menu in the editor bar.
			** Start typing your categories and add them.

	== Process using On-line Converter ==		== Process using On-line Converter ==

Anw: Updated

2025-07-23T10:42:03Z

Updated

← Older revision		Revision as of 12:42, 23 July 2025
Line 144:		Line 144:
	*** ''The text I pasted in had images. Can you identify where those images were and put a placeholder in there of <nowiki>[[File:SYS-DESC.png\|800px]]</nowiki>''		*** ''The text I pasted in had images. Can you identify where those images were and put a placeholder in there of <nowiki>[[File:SYS-DESC.png\|800px]]</nowiki>''
	*** ''Can you make the placeholder count please? e.g. SYS-DESC-1.png, SYS-DESC-2.png, etc''		*** ''Can you make the placeholder count please? e.g. SYS-DESC-1.png, SYS-DESC-2.png, etc''
			*** ''Any A.# headings should be level 2. Same for B.#, C.#.''
	** E.g. Aurora/ChatGPT including prompts:		** E.g. Aurora/ChatGPT including prompts:
	*** ''Please convert my text into mediawiki format''		*** ''Please convert my text into mediawiki format''

Anw: Updated

2025-07-22T15:34:43Z

Updated

← Older revision		Revision as of 17:34, 22 July 2025
Line 1:		Line 1:
			This guide is intended to show the processes that can be followed to convert a document (DOCX by preference) into an Assist page.

			There are multiple methods and processes, including some not documented here, such as using LibreOffice or a Word extension, neither having produced reasonable results or time savings.

			The processes below will automate vast tracts of the process and make the conversion of documents much easier and less time consuming.

	== Tools ==		== Tools ==

Anw: Updated

2025-07-22T15:31:48Z

Updated

@@ Line 13: / Line 13: @@
 * https://learn.microsoft.com/en-us/windows/powertoys/install
-==  Process ==
+* Aurora/Direct ChatGPT
 Convert document using Vertopal online conversion tool
 * https://www.vertopal.com/en/convert/docx-to-wiki-mediawiki
@@ Line 93: / Line 101: @@
 | Image20a-text || TTM-WMS-20a-text
 |}
 When renamed, use the Upload Multiple Files Special page to upload the files in bulk:
@@ Line 106: / Line 116: @@
 Finally, check the sizes of all pictures - remove or add |800px if necessary.
 [[Category:Assist Guides]]
 [[Category:ASSIST]]

Anw: Added PowerToys for renaming.

2025-05-08T07:50:09Z

Added PowerToys for renaming.

← Older revision		Revision as of 09:50, 8 May 2025
Line 2:		Line 2:

	Recommended initial editing tool - NOTEPAD++		Recommended initial editing tool - NOTEPAD++
			* https://notepad-plus-plus.org/downloads/

	Create Macro - Assist Cleanup		Create Macro - Assist Cleanup
Line 8:		Line 9:
	Create Macro - Vertopal Cleanup		Create Macro - Vertopal Cleanup
	* See documentation - [[Assist Clean Up Vertopal Macro]]		* See documentation - [[Assist Clean Up Vertopal Macro]]

			Recommended - PowerToys
			* https://learn.microsoft.com/en-us/windows/powertoys/install


	== Process ==		== Process ==

	Convert document using Vertopal online conversion tool		Convert document using Vertopal online conversion tool
			* https://www.vertopal.com/en/convert/docx-to-wiki-mediawiki
	https://www.vertopal.com/en/convert/docx-to-wiki-mediawiki

	Use DOC/DOCx - PDF doesn't work very well.		Use DOC/DOCx - PDF doesn't work very well.

	NOTE: This does not convert embedded objects like excel, attachments, Visio or Word diagrams. If your document contains these, then ~~svae~~ these as PNG images to add to the document later.		NOTE: This does not convert embedded objects like excel, attachments, Visio or Word diagrams. If your document contains these, then save these as PNG images to add to the document later.

	Download and Extract to subfolder		Download and Extract to subfolder
Line 65:		Line 67:
	Put into Assist		Put into Assist

	Upload images using the numbers as guide.		Rename images - Recommend using PowerRename from PowerToys.
			* Select all images to be renamed, then right-click and Select Rename with PowerRename.
			* If from Vertopal, the images are in a media subdirectory, names as image1, image2, etc.
			* Tick "User regular expressions"
			* From name: image(.*)
			* To name: SYS-DESC-$1

			Example:
			* From name: image(.*)
			* To name: TTM-WMS-$1

			{\| class="wikitable"
			\|+ Results
			\|-
			! From !! To
			\|-
			\| Image1 \|\| TTM-WMS-1
			\|-
			\| Image2 \|\| TTM-WMS-2
			\|-
			\| Image10 \|\| TTM-WMS-10
			\|-
			\| Image11 \|\| TTM-WMS-11
			\|-
			\| Image20a-text \|\| TTM-WMS-20a-text
			\|}

			When renamed, use the Upload Multiple Files Special page to upload the files in bulk:
			* Go to Special pages
			* Click Upload multiple files.
			* Enter a description for the images (otherwise this will default to something useless).
			* Drag your images to be uploaded to the appropriate place on the page.
			* The images will upload automatically, showing the progress on the screen.
			* If any images should fail, try re-uploading them - sometimes bulk uploading >40 images at a time will cause some issues.

			If you are doing this manually instead, upload the images by clicking on the image in the document and then manually upload the correct "imageX" file using the numbers as guide.

	~~Check~~ sizes of all pictures - remove or add \|800px if necessary.		Finally, check the sizes of all pictures - remove or add \|800px if necessary.

	[[Category:Assist Guides]]		[[Category:Assist Guides]]
	[[Category:ASSIST]]		[[Category:ASSIST]]

Anw: Updated to latest version

2025-05-01T15:16:52Z

Updated to latest version

← Older revision		Revision as of 17:16, 1 May 2025
Line 4:		Line 4:

	Create Macro - Assist Cleanup		Create Macro - Assist Cleanup
	* See documentation - Assist Cleanup Macro		* See documentation - [[Assist Cleanup Macro]]

			Create Macro - Vertopal Cleanup
			* See documentation - [[Assist Clean Up Vertopal Macro]]


Line 23:		Line 26:
	Run Macro - Assist Cleanup		Run Macro - Assist Cleanup

	~~Replace following (~~this ~~assumes replacing for a document for TTM - replace TTM- with~~ the ~~name of your Assist and doc being converted e.g. WMS-, PORTAL-TTM-ARCH-, EPOD-DEVICE-, CTLTMS-, etc~~		Run Macro - Clean Up Vertopal

			Essentially this does the following:

	<pre>		<pre>
Line 45:		Line 50:
	</pre>		</pre>

			{{Note}} Replace in the above - this assumes replacing for a document for TTM - replace TTM- with the name of your Assist and doc being converted e.g. WMS-, PORTAL-TTM-ARCH-, EPOD-DEVICE-, CTLTMS-, etc

			The Vertopal Cleanup macro will put in "SYS-DESC-", so replace that.

	Go through and ensure images are named with a reasonable name		Go through and ensure images are named with a reasonable name

Anw: Minor correction

2024-08-28T07:09:37Z

Minor correction

← Older revision		Revision as of 09:09, 28 August 2024
Line 23:		Line 23:
	Run Macro - Assist Cleanup		Run Macro - Assist Cleanup

	Replace following		Replace following (this assumes replacing for a document for TTM - replace TTM- with the name of your Assist and doc being converted e.g. WMS-, PORTAL-TTM-ARCH-, EPOD-DEVICE-, CTLTMS-, etc

	<pre>		<pre>
	<span.*</span> with nothing		<span.*</span> with nothing

	\[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image with \[\[File\:~~vertopal_392608dac46847cb99daf0bb8d5090ed/media/image~~		\[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image with \[\[File\:TTM-

	\.png\\|.*?\]\] with \.png\\|800px\]\] (if mostly huge images) or \.png\]\] (if mostly small images)		\.png\\|.*?\]\] with \.png\\|800px\]\] (if mostly huge images) or \.png\]\] (if mostly small images)
Line 48:		Line 48:
	Go through and ensure images are named with a reasonable name		Go through and ensure images are named with a reasonable name

	e.g. if in home section in TTM change file from TTM-1.png to TTM-HOME-1.PNG		e.g. if in home section in TTM, change file from TTM-1.png to TTM-HOME-1.PNG

	Check all images now have a name - search for File\:		Check all images now have a name - search for File\:

Anw: Minor correction

2024-08-08T12:17:04Z

Minor correction

← Older revision		Revision as of 14:17, 8 August 2024
Line 30:		Line 30:
	\[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image with \[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image		\[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image with \[\[File\:vertopal_392608dac46847cb99daf0bb8d5090ed/media/image

	\.png\\|.*?\]\] with \.png\\|800px\]\]		\.png\\|.*?\]\] with \.png\\|800px\]\] (if mostly huge images) or \.png\]\] (if mostly small images)

	<\/?blockquote> with nothing		<\/?blockquote> with nothing
Line 40:		Line 40:
	= <br />\n with "= " (without the quotes)		= <br />\n with "= " (without the quotes)

	\{\\| with \{\\| class="wikitable"		\{\\| with \{\\| class="wikitable" border="1"

	!width="\d*%"\\| with !		!width="\d*%"\\| with !
Line 59:		Line 59:
	Upload images using the numbers as guide.		Upload images using the numbers as guide.

	Check sizes of all pictures - remove \|800px if necessary.		Check sizes of all pictures - remove or add \|800px if necessary.

	[[Category:Assist Guides]]		[[Category:Assist Guides]]
	[[Category:ASSIST]]		[[Category:ASSIST]]

Anw: Categorisation

2024-08-05T12:37:37Z

Categorisation

← Older revision		Revision as of 14:37, 5 August 2024
Line 62:		Line 62:

	[[Category:Assist Guides]]		[[Category:Assist Guides]]
			[[Category:ASSIST]]