User:Max34/VDCEditor

From Valve Developer Community
Jump to: navigation, search

VDCEditor is an extension that will change the edit field from a regular flat textarea into a full-fledged code editor with syntax highlighting, line numbering and much more.

Note.pngNote:Despite the fact that this extension is made for the Valve Developer Community, it can probably work on any other wikis running on the MediaWiki engine.

Download v0.1

Warning.pngWarning:This extension may be unstable because it’s still under development. By installing it, you agree that I (as the creator of this extension) am not responsible for any shortcomings. You also agree that you will install the unpacked extension yourself. This is necessary due to the fact that browsers can block packaged extensions installed not from their store.
Note.pngNote:Since my skills in writing extensions are not very great, editing may lag if there is a lot of code.

Download link (Google Drive): https://drive.google.com/file/d/1nLlIZScqa4tEzEuQ6iepLcbCAM-eBFBs/view?usp=sharing

How to use the extension

Installing (chromium based browsers)

  1. Follow the link to install .zip archive
  2. After installation, you need to unpack the archive and you should have the following structure: the “VDCEditor” folder and inside it all the extension files
  3. Place the extension folder in any location you need on your computer
  4. Open your browser and open the chrome://extensions/
  5. You will have to find the "Developer Mode" switch and activate it
  6. After this, you should see a button “load unpacked extension”
  7. Click on this button and select the folder of this extension

When you are done, the VDCEditor extension marked as “unpacked extension” should appear in the list of extensions.

Installing (Firefox)

  1. Follow the link to install .zip archive
  2. After installation place the archive in any location you need on your computer
  3. Open Firefox and type about:config in the search bar
  4. You will see a warning message, and after clicking the button, an input field
  5. Enter axpinstall.signatures.required in this field. You need to switch it to the false state
  6. Now go to your extensions list (about:addons), click on the gear icon and select “Install add-on from file”
  7. Select a previously installed archive

When you're done, the VDCEditor extension with a warning that this extension is not verified should appear in the list of extensions.

Note.pngNote:If the extension does not launch on its own, click on the extensions button in the upper right corner of the browser while you are on VDC site and right-click on the VDCEditor icon. Select "Always allow on developer.valvesoftware.com".

Using the extension

  1. You must be logged in to this site
  2. Go to any page that you can edit
  3. Click the Edit tab

Development progress

Make the first edit using the new editor

Change the style of the entire editor to the dark version

Implement the correct automatic loading of the script

Add line numbering

Add Word Wrap setting

☐ Add code font size setting

Make editor height saveable

Make a status bar

Add an indicator of the number of characters in the code

Add a carriage location indicator

Add highlighting of MediaWiki magic words

☐ Add highlighting to ϧ elements

Add highlighting for mnemonics (not all mnemonics have been added. Need a complete list of mnemonics working on this site)

Add highlighting to HTML elements

Add highlighting to MediaWiki elements (hardest one)

☐ Implement the loading of translations directly from the VDC so that users can translate the extension directly from the site

☐ Implement the loading of brief documentation of templates when hovering over them with the mouse with Ctrl pressed

☐ Implement a color square next to each color (as in F12)

Add attributes to disable unwanted actions with the editor (translate="no", spellcheck="false", autocorrect="off", autocapitalize="off")

Add scrolling below content until only the last line is shown

Add highlighting to parts of code similar to the part that was selected

Add setting to disable highlighting of similar text as selected text

☐ Add a setting to display control characters

Add an icon and extension name to the top left corner of the editor to make it look like a separate application

☐ Adapt the editor to display correctly in right-to-left mode

Add preserving indentation (tabs and spaces) at the beginning of a line when creating a new line

Add a setting to disable scrolling below the last line

Add a setting to disable template styling. This styling is still quite unstable

☐ Add auto-completion of templates and their shortcuts.

Add the ability to duplicate selected text (or a line if nothing is selected) when pressing Ctrl + D

Reduce the “editpage-copywarn” font a little (maybe it’s worth coming up with another way to reduce the space this text takes up)

Style the diff table to match the site theme (styled both when editing and when viewing the history of page changes)

☐ Replace the Ctrl+B and Ctrl+I keyboard shortcuts with automatic insertion of single quotes (the contenteditable div turns out to add these keyboard shortcuts, and given how exactly this extension is made, the original functionality of these shortcuts can break the entire editor)


(For copying: ☐ )