doc:editor

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
doc:editor [2010/03/12 02:07] – partial english rewrite philipdoc:editor [2018/09/13 03:11] (current) – Wording some misspellings carusogabriel
Line 1: Line 1:
 ====== Getting started ====== ====== Getting started ======
-Eventually the documentation at php.net will link to the online editor, which will allow anyone (anonymous or not) to edit manual pages.+Currently all documentation pages at php.net have a link to the online editor, which allow anyone (anonymous or not) to edit manual pages. The link is placed under language select
  
-The editor may also be accessed from here: http://edit.php.net/+The editor may also be accessed from here: https://edit.php.net/
  
-====== Who can edit a page ? ======+====== Who can edit a page? ======
   * Anonymous users may create patches   * Anonymous users may create patches
   * People with SVN accounts may apply their and other peoples patches   * People with SVN accounts may apply their and other peoples patches
 +
 ===== Anonymous users ===== ===== Anonymous users =====
 +{{:doc:phdoe_login.png}}
  
-{{:doc:phdoe_login.png | }} +When the application starts, the default Login is "Anonymous", with a blank password. You may login-in anonymously via :
-When the application starts, the default Login is "Anonymous", with a blank password. You may login-in with an empty Login / empty password too.+
  
-An anonymous user can edit any page and save the work as patch. While saving, an email may be entered that'll then be notified when the patch is approved or deleted. And all users may view patches under the "Pending Patch" tab.+  * an empty Login / empty password 
 +  * your [[https://www.facebook.com|Facebook]] account 
 +  * your [[https://www.github.com|Github]] account 
 +  * your [[https://www.google.com|Google]] account 
 +  * your [[https://www.linkedin.com|Linkedin]] account 
 +  * your [[https://www.stackoverflow.com|Stackoverflow]] account 
 +  * your [[https://www.instagram.com|Instagram]] account 
 + 
 +With a Facebook/Github/Google/Lindekin/Stackoverflow/Instagram account, we can better identify the user who submitted a patch. 
 + 
 +An anonymous user can edit any page and save the work as patch. While saving, an email may be entered that'll then be notified when the patch is approved or deleted. And all users may view patches under the "Pending Patch" tab.
  
 ===== SVN users ===== ===== SVN users =====
- 
 People with SVN accounts (and appropriate karma) may login using said account. With it you can: People with SVN accounts (and appropriate karma) may login using said account. With it you can:
  
Line 22: Line 32:
   * commit your changes   * commit your changes
   * commit other peoples pending patches    * commit other peoples pending patches 
- 
-====== Main Menu ====== 
- 
-===== Refresh all data ===== 
-===== Build Tools ===== 
-==== Check Build ==== 
-==== Last Failed Build ==== 
- 
-===== EN tools ===== 
-==== Script Check Entities ==== 
-===== View the last result ===== 
-===== Run this script ===== 
- 
-==== Script Check doc ==== 
- 
-===== Configure ===== 
-===== Erase my personal data ===== 
-===== Log out ===== 
-===== Report bugs ===== 
-===== Documentation ===== 
-===== About ===== 
  
 ====== All modules ====== ====== All modules ======
-All module are available for all languages except English, because translation related modules (likegraphs displaying the translation percentage) don't make sense for English.+All modules are available for all languages except English, because translation related modules (like graphs displaying the translation percentage) don't make sense for English.
  
 ===== Files Needing Translation ===== ===== Files Needing Translation =====
 {{ :doc:phdoe_need_translate.png?300|}} {{ :doc:phdoe_need_translate.png?300|}}
 +
 This module displays all the files that are available in the English documentation, that are not yet translated in the chosen language. This module displays all the files that are available in the English documentation, that are not yet translated in the chosen language.
  
 Simply double-click on a file to open a new tab. The English file is displayed and you can start translating it directly. Simply double-click on a file to open a new tab. The English file is displayed and you can start translating it directly.
  
-<code>Don't forget to add the Revcheck and Reviewed tags before saving your work. You can insert them via the file menu "MarkUp".</code>+Revcheck and Reviewed tags will be added automatically by the editor, with the right version number, and your name as Maintainer  
 +Although, You can insert them via the file menu "MarkUp".
  
 Once you have modified this file, you may save your work (for SVN authenticated users), or save it as a patch (for anonymous users). Once you have modified this file, you may save your work (for SVN authenticated users), or save it as a patch (for anonymous users).
  
 Your modifications appear respectively in the "Pending Commit" or the "Pending Patch" modules. Your modifications appear respectively in the "Pending Commit" or the "Pending Patch" modules.
-\\  
-\\  
-\\  
-\\  
-\\  
-\\  
-\\  
-\\  
  
 ===== Files Need Update ===== ===== Files Need Update =====
 {{ :doc:phdoe_need_update.png?500|}} {{ :doc:phdoe_need_update.png?500|}}
-Based on the Revcheck tag, this module lists all files which have been modified in English but not yet synchronized in the chosen language. All files are sorted by folder and then filename.+ 
 +Based on the Revcheck tag, this module lists all files which have been modified in English but not yet synchronized in the chosen language. All files are sorted by folder and their filename.
  
 <code><!-- EN-Revision: 288721 Maintainer: felipe Status: ready --></code> <code><!-- EN-Revision: 288721 Maintainer: felipe Status: ready --></code>
 +
 +**Don't forget** to update manually the EN-Revision number to the revision number in English from which you update the given file.
  
 You may simply double-click on a file to start editing them into a new tab. You may simply double-click on a file to start editing them into a new tab.
 You may also right-click on it to display context menu, which then offers several other options. You may also right-click on it to display context menu, which then offers several other options.
  
-Once you start editing a file, the main panel display 4 sub-panel:+Once you start editing a file, the main panel display 4 sub-panels:
  
    * On the top, the diff presents all modification made to the English language.    * On the top, the diff presents all modification made to the English language.
    * On the right, you can display the SVN log for this file, both as the chosen language and English.    * On the right, you can display the SVN log for this file, both as the chosen language and English.
-   * On the center you have 2 panels:+   * On the centeryou have 2 panels:
       * One for the LANG file       * One for the LANG file
       * One for the EN file       * One for the EN file
Line 90: Line 76:
 ===== Error in current translation ===== ===== Error in current translation =====
 {{ :doc:phdoe_file_error.png?500|}} {{ :doc:phdoe_file_error.png?500|}}
-This module present all files in error. + 
-When the data is updated, there is a lot of checks done once each files+This module presents all files in error. 
-You can view all checks done by right-click on a file and chose the sub-menu "About error type". This action display all error type into a new tab.+When the data is updated, there is a lot of checks done once each file
 +You can view all checks done by right-click on a file and chose the sub-menu "About error type". This action displays all error type into a new tab.
  
 One you double-click into a file of this module, a new tab is open, similar to a "need update" tab. One you double-click into a file of this module, a new tab is open, similar to a "need update" tab.
Line 98: Line 85:
     * On the top, the error type for this file.     * On the top, the error type for this file.
     * On the right, you can display all SVN log for this file, into the chosen language, and into English.     * On the right, you can display all SVN log for this file, into the chosen language, and into English.
-    * On the center you have 2 panels :+    * On the centeryou have 2 panels :
           * One for the lang file           * One for the lang file
           * One for the EN file           * One for the EN file
Line 108: Line 95:
 ===== Files Need Reviewed ===== ===== Files Need Reviewed =====
 {{ :doc:phdoe_need_reviewed.png?500|}} {{ :doc:phdoe_need_reviewed.png?500|}}
 +
 This module displays all files which need to be reviewed (based on the reviewed tag). This module displays all files which need to be reviewed (based on the reviewed tag).
 <code><!-- Reviewed: No --></code> <code><!-- Reviewed: No --></code>
Line 117: Line 105:
  
     * On the right, you can display the SVN log for this file, both from the chosen language, and English.     * On the right, you can display the SVN log for this file, both from the chosen language, and English.
-    * On the center you have 2 panels:+    * On the centeryou have 2 panels:
           * One for the LANG file           * One for the LANG file
           * One for the EN file           * One for the EN file
Line 125: Line 113:
 Your modification appears respectively in the 'Pending Commit' or the 'Pending Patch' module. Your modification appears respectively in the 'Pending Commit' or the 'Pending Patch' module.
  
-<code>The context menu allow you to open all files for the current extension. So, you can review all files for a given extension and be more consistent with your work.</code>+<code>The context menu allows you to open all files for the current extension. So, you can review all files for a given extension and be more consistent with your work.</code>
  
 ===== Not in EN ===== ===== Not in EN =====
 {{ :doc:phdoe_notinen.png?500|}} {{ :doc:phdoe_notinen.png?500|}}
 +
 This module lists all files which are in the chosen language, but not in EN. This module lists all files which are in the chosen language, but not in EN.
 Usually, this happens when a file is deleted from EN tree but not yet synced in the chosen language. Usually, this happens when a file is deleted from EN tree but not yet synced in the chosen language.
  
-After double-clicking, a new tab will open and you can view the files contents. It cannot be edited here.+After double-clicking, a new tab will open and you can view the file'contents. It cannot be edited here.
  
 Right-click on it and choose "Remove this file" to add it to Pending Commit module. Right-click on it and choose "Remove this file" to add it to Pending Commit module.
  
-<code>An anonymous user can mark a file to be deleted, as this really only appends on commit.</code> +An anonymous user can mark a file to be deleted, as this really only appends on commit.
- +
-\\  +
-\\  +
-\\  +
-\\  +
-\\ +
  
 ===== All files ===== ===== All files =====
 {{ :doc:phdoe_all_files.png?500|}} {{ :doc:phdoe_all_files.png?500|}}
 +
 This module allows you to browse the entire repository for the English language, or the chosen language. This module allows you to browse the entire repository for the English language, or the chosen language.
  
-This is useful when you want to edit some files witch are ignore by others modules (like entities.*).+This is useful when you want to edit some files which are ignored by other modules (like entities.* files, which are auto-generated).
  
-So, you can edit any files, save it or make a patch, and add it to Pending Commit module.+So, you can edit any file, save it or make a patch, and then add it to the 'Pending Commitmodule.
  
-The context menu allow you to start editing the file into a new tab, but also open the same file into the EN tree (if the file is a chosen language file) or into the chose language (if the file is an EN file). +The context menu allows you to start editing the file as a new tab, but it also opens the same file into the EN tree (if the file is a chosen language file) or into the chosen language (if the file is an EN file).
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\ +
  
 ===== Pending for commit ===== ===== Pending for commit =====
 {{ :doc:phdoe_pending_commit.png|}} {{ :doc:phdoe_pending_commit.png|}}
-This module list all files witch have been modified by you, or by others peoples (authenticate or not) for English files and for the chosen language. 
  
-All action (and sub-menu) depends on where the file have been modified.+This module lists all files which have been modified by you, or by other peoples (authenticated or not) for English files, and for the chosen language.
  
-== File modified from "Need Translate" module ==+All action (and sub-menus) depend on where the file has been modified.
  
-A double-click on this type of file open it as it will be open from the "Need Translate" module.+== File modified from "Need Translate" module == 
 +A double-click on this type of file opens it as if it's been opened from the "Need Translate" module.
  
-The following action are available via the context-menu : +The following actions are available via the context-menu : 
-  - Edit in a new tab : this is the default action. Same as a double-click directly on the file in the grid. +  - Edit in a new tab : this is the default action. It's the same as a double-click directly on the file in the grid. 
-  - Clear this change : cancel this modification.+  - Clear this change : cancels the modification.
   - Commit : Common commit menu (see below)   - Commit : Common commit menu (see below)
  
 == File modified from "Need Update" module == == File modified from "Need Update" module ==
-A double-click on this type of file open it as it will be open from the "Need Update" module.+A double-click on this type of file opens it as if it was opened from the "Need Update" module.
  
-The following action are available via the context-menu :   +The following actions are available via the context-menu :   
-  - Edit in a new tab : this is the default action. Same as a double-click directly on the file in the grid. +  - Edit in a new tab : this is the default action. Same as a double-clicking directly on the file in the grid. 
-  - View diff : Open a tab and display the difference between the original version and the modified version of this file. +  - View diff : Opens a tab and displays the difference between the original version and the modified version of this file. 
-  - Download the diff as a patch : Open the default download window for downloading the difference as a patch file. +  - Download the diff as a patch : Opens the default download window for downloading the difference (diff) as a patch file. 
-  - Clear this change : cancel this modification.+  - Clear this change : cancels the modification.
   - Commit : Common commit menu (see below)     - Commit : Common commit menu (see below)  
  
 == File modified from "Error in current translation" module == == File modified from "Error in current translation" module ==
-A double-click on this type of file open it as it will be open from the "Error in current translation" module.+A double-click on this type of file opens it as if it was opened from the "Error in current translation" module.
  
 The context-menu is identical to the context-menu of a file modified from "Need Update" module. The context-menu is identical to the context-menu of a file modified from "Need Update" module.
  
 == File modified from "Files Need Reviewed" module == == File modified from "Files Need Reviewed" module ==
-A double-click on this type of file open it as it will be open from the "Files Need Reviewed" module.+A double-click on this type of file opens it as if it was opened from the "Files Need Reviewed" module.
  
 The context-menu is identical to the context-menu of a file modified from "Need Update" module. The context-menu is identical to the context-menu of a file modified from "Need Update" module.
  
 == File modified from "Not in EN" module == == File modified from "Not in EN" module ==
-A double-click on this type of file open it as it will be open from the "Not in EN" module.+A double-click on this type of file opens it as if it was opened from the "Not in EN" module.
  
-The following action are available via the context-menu :   +The following actions are available via the context-menu :   
-  - View in a new tab : this is the default action. Same as a double-click directly on the file in the grid. Display the content of the file into a new tab, in read-only mode.+  - View in a new tab : this is the default action. Same as a double-clicking directly on the file in the grid. Displays the content of the file as a new tab, in read-only mode.
   - Clear this deletion   - Clear this deletion
   - Commit : Common commit menu (see below)     - Commit : Common commit menu (see below)  
  
 == File modified from "All files" module == == File modified from "All files" module ==
-A double-click on this type of file open it as it will be open from the "Files Need Reviewed" module.+A double-click on this type of file opens it as if it was opened from the "Files Need Reviewed" module.
  
 The context-menu is identical to the context-menu of a file modified from "Need Update" module. The context-menu is identical to the context-menu of a file modified from "Need Update" module.
  
-==== ==== +==== Committing changes ==== 
-From all of this, there is a default sub-menu "**Commit...**" witch allow you to :+From all of this, there is a default sub-menu "**Commit...**" which allows you to:
  
-  * Commit this file : this open the commit window with just one file ; this from witch we have right-clicked from+  * Commit this file: this opens the commit window with just one file; which is the file that was right-clicked on
-  * Commit all files modified by the current user : this open the commit window containing all files modified by the current user for the chosen language and for ENglish language. +  * Commit all files modified by the current user: this opens the commit window containing all files modified by the current user for the chosen languageand for English language. 
-  * commit all files modified by everyone : this open the commit window containing all files modified for the chosen language and for ENglish language.+  * commit all files modified by everyone: this opens the commit window containing all files modified for the chosen language and for English language.
  
 == The commit window == == The commit window ==
 {{ :doc:pdoe_commit_window.png?300|}} {{ :doc:pdoe_commit_window.png?300|}}
-This window is compose of 3 panels :+ 
 +This window is composed of 3 panels:
   * The list of files you want to commit   * The list of files you want to commit
-  Each file have a checkbox (checked by default) to allow you to exclude it for the current commit, or not. +  Each file has a checkbox (checked by default) to allow you to exclude it for the current commit, or not. 
-  * The list of old commit message+  * The list of old commit messages
   Each time you commit, by default, your message is saved and you can use the element to re-use it.   Each time you commit, by default, your message is saved and you can use the element to re-use it.
   * The area to enter the log message for the current commit   * The area to enter the log message for the current commit
  
-Just hint the "Submit" button to commit selected files, by using the message as VCS log message. +Select the "Submit" button to commit selected files, by using the message as VCS log message. 
-Once the commit is done, some part of the window are reloaded to reflect the new states of the documentation. +Once the commit is done, part of the window is reloaded to reflect the new state of the documentation. 
-\\  + 
-\\  +== Manage your old commit messages ==
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-\\  +
-== Manage your old commit message ==+
 {{ :doc:pdoe_manage_log_message.png?300|}} {{ :doc:pdoe_manage_log_message.png?300|}}
-In the commit window, you can see on the top - right, a little gear, allowing you to manage your old commit message. 
-A click on it open a window where you can delete / modify your commit log messages. 
  
-To delete a message, just right click on it and chose "Delete this log message"+In the commit window, you can see on the top - right, a little gear, which allows you to manage your old commit messages. 
-To modify a message, just double-click on it and modify it ! Just click outside of the field to save it automatically +A click on it opens a window where you can delete / modify your commit log messages. 
-\\  + 
-\\  +To delete a message, just right-click on it and choose "Delete this log message"
-\\  +To modify a message, just double-click on it and modify it. Then, click outside of the field to save it automatically.
-\\  +
-\\  +
-\\ +
  
 ===== Pending Patch ===== ===== Pending Patch =====
 {{ :doc:pdoe_patch_area.png?500|}} {{ :doc:pdoe_patch_area.png?500|}}
-This module list all pending patchs, ready to be committed for the chosen language and for the English language. 
  
-As of "Pending Commit", you must be an authenticated user to manage all patchs.+This module lists all pending patches, which are ready to be committed for the chosen language and for the English language. 
 + 
 +Just like "Pending Commit", you must be an authenticated user to manage all patches.
  
-When you double-click on a patch, a new tab is open and is composed of 4 panels : +When you double-click on a patch, a new tab is opened and it is composed of 4 panels: 
-  * On the top, the diff from the original version and the modified +  * On the top, the diff of the original and modified versions 
-  * On the left, a panel to display VCS log message +  * On the left, a panel to display VCS log messages 
-  * On the center, 2 panels :+  * On the center, 2 panels:
     * On the left, the patched version of the file     * On the left, the patched version of the file
     * On the right, the original version of the file     * On the right, the original version of the file
  
-Directly into the editor of the patched version, you have some button available via the tools bar : +Directly in the editor of the patched version, you have buttons available via the tools bar: 
-  * Accept this patch and save the file : The patch disappears from "Pending Patch" module and appears in the "Pending Commit" module. +  * Accept this patch and save the file: The patch disappears from the "Pending Patch" module and appears in the "Pending Commit" module. 
-  * Reject the patch : The patch disappears from "Pending Patch" module.+  * Reject the patch: The patch disappears from the "Pending Patch" module.
  
-When you accept or reject a patch, the user receive an email if he have leave one when he have created the patch.+When you accept or reject a patch, the user receives an email if they have left one when the patch was created.
doc/editor.1268359632.txt.gz · Last modified: 2017/09/22 13:28 (external edit)