diff --git a/COPYING b/COPYING deleted file mode 100644 index a43ea21..0000000 --- a/COPYING +++ /dev/null @@ -1,339 +0,0 @@ - GNU GENERAL PUBLIC LICENSE - Version 2, June 1991 - - Copyright (C) 1989, 1991 Free Software Foundation, Inc. - 675 Mass Ave, Cambridge, MA 02139, USA - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The licenses for most software are designed to take away your -freedom to share and change it. By contrast, the GNU General Public -License is intended to guarantee your freedom to share and change free -software--to make sure the software is free for all its users. This -General Public License applies to most of the Free Software -Foundation's software and to any other program whose authors commit to -using it. (Some other Free Software Foundation software is covered by -the GNU Library General Public License instead.) You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -this service if you wish), that you receive source code or can get it -if you want it, that you can change the software or use pieces of it -in new free programs; and that you know you can do these things. - - To protect your rights, we need to make restrictions that forbid -anyone to deny you these rights or to ask you to surrender the rights. -These restrictions translate to certain responsibilities for you if you -distribute copies of the software, or if you modify it. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must give the recipients all the rights that -you have. You must make sure that they, too, receive or can get the -source code. And you must show them these terms so they know their -rights. - - We protect your rights with two steps: (1) copyright the software, and -(2) offer you this license which gives you legal permission to copy, -distribute and/or modify the software. - - Also, for each author's protection and ours, we want to make certain -that everyone understands that there is no warranty for this free -software. If the software is modified by someone else and passed on, we -want its recipients to know that what they have is not the original, so -that any problems introduced by others will not reflect on the original -authors' reputations. - - Finally, any free program is threatened constantly by software -patents. We wish to avoid the danger that redistributors of a free -program will individually obtain patent licenses, in effect making the -program proprietary. To prevent this, we have made it clear that any -patent must be licensed for everyone's free use or not licensed at all. - - The precise terms and conditions for copying, distribution and -modification follow. - - GNU GENERAL PUBLIC LICENSE - TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION - - 0. This License applies to any program or other work which contains -a notice placed by the copyright holder saying it may be distributed -under the terms of this General Public License. The "Program", below, -refers to any such program or work, and a "work based on the Program" -means either the Program or any derivative work under copyright law: -that is to say, a work containing the Program or a portion of it, -either verbatim or with modifications and/or translated into another -language. (Hereinafter, translation is included without limitation in -the term "modification".) Each licensee is addressed as "you". - -Activities other than copying, distribution and modification are not -covered by this License; they are outside its scope. The act of -running the Program is not restricted, and the output from the Program -is covered only if its contents constitute a work based on the -Program (independent of having been made by running the Program). -Whether that is true depends on what the Program does. - - 1. You may copy and distribute verbatim copies of the Program's -source code as you receive it, in any medium, provided that you -conspicuously and appropriately publish on each copy an appropriate -copyright notice and disclaimer of warranty; keep intact all the -notices that refer to this License and to the absence of any warranty; -and give any other recipients of the Program a copy of this License -along with the Program. - -You may charge a fee for the physical act of transferring a copy, and -you may at your option offer warranty protection in exchange for a fee. - - 2. You may modify your copy or copies of the Program or any portion -of it, thus forming a work based on the Program, and copy and -distribute such modifications or work under the terms of Section 1 -above, provided that you also meet all of these conditions: - - a) You must cause the modified files to carry prominent notices - stating that you changed the files and the date of any change. - - b) You must cause any work that you distribute or publish, that in - whole or in part contains or is derived from the Program or any - part thereof, to be licensed as a whole at no charge to all third - parties under the terms of this License. - - c) If the modified program normally reads commands interactively - when run, you must cause it, when started running for such - interactive use in the most ordinary way, to print or display an - announcement including an appropriate copyright notice and a - notice that there is no warranty (or else, saying that you provide - a warranty) and that users may redistribute the program under - these conditions, and telling the user how to view a copy of this - License. (Exception: if the Program itself is interactive but - does not normally print such an announcement, your work based on - the Program is not required to print an announcement.) - -These requirements apply to the modified work as a whole. If -identifiable sections of that work are not derived from the Program, -and can be reasonably considered independent and separate works in -themselves, then this License, and its terms, do not apply to those -sections when you distribute them as separate works. But when you -distribute the same sections as part of a whole which is a work based -on the Program, the distribution of the whole must be on the terms of -this License, whose permissions for other licensees extend to the -entire whole, and thus to each and every part regardless of who wrote it. - -Thus, it is not the intent of this section to claim rights or contest -your rights to work written entirely by you; rather, the intent is to -exercise the right to control the distribution of derivative or -collective works based on the Program. - -In addition, mere aggregation of another work not based on the Program -with the Program (or with a work based on the Program) on a volume of -a storage or distribution medium does not bring the other work under -the scope of this License. - - 3. You may copy and distribute the Program (or a work based on it, -under Section 2) in object code or executable form under the terms of -Sections 1 and 2 above provided that you also do one of the following: - - a) Accompany it with the complete corresponding machine-readable - source code, which must be distributed under the terms of Sections - 1 and 2 above on a medium customarily used for software interchange; or, - - b) Accompany it with a written offer, valid for at least three - years, to give any third party, for a charge no more than your - cost of physically performing source distribution, a complete - machine-readable copy of the corresponding source code, to be - distributed under the terms of Sections 1 and 2 above on a medium - customarily used for software interchange; or, - - c) Accompany it with the information you received as to the offer - to distribute corresponding source code. (This alternative is - allowed only for noncommercial distribution and only if you - received the program in object code or executable form with such - an offer, in accord with Subsection b above.) - -The source code for a work means the preferred form of the work for -making modifications to it. For an executable work, complete source -code means all the source code for all modules it contains, plus any -associated interface definition files, plus the scripts used to -control compilation and installation of the executable. However, as a -special exception, the source code distributed need not include -anything that is normally distributed (in either source or binary -form) with the major components (compiler, kernel, and so on) of the -operating system on which the executable runs, unless that component -itself accompanies the executable. - -If distribution of executable or object code is made by offering -access to copy from a designated place, then offering equivalent -access to copy the source code from the same place counts as -distribution of the source code, even though third parties are not -compelled to copy the source along with the object code. - - 4. You may not copy, modify, sublicense, or distribute the Program -except as expressly provided under this License. Any attempt -otherwise to copy, modify, sublicense or distribute the Program is -void, and will automatically terminate your rights under this License. -However, parties who have received copies, or rights, from you under -this License will not have their licenses terminated so long as such -parties remain in full compliance. - - 5. You are not required to accept this License, since you have not -signed it. However, nothing else grants you permission to modify or -distribute the Program or its derivative works. These actions are -prohibited by law if you do not accept this License. Therefore, by -modifying or distributing the Program (or any work based on the -Program), you indicate your acceptance of this License to do so, and -all its terms and conditions for copying, distributing or modifying -the Program or works based on it. - - 6. Each time you redistribute the Program (or any work based on the -Program), the recipient automatically receives a license from the -original licensor to copy, distribute or modify the Program subject to -these terms and conditions. You may not impose any further -restrictions on the recipients' exercise of the rights granted herein. -You are not responsible for enforcing compliance by third parties to -this License. - - 7. If, as a consequence of a court judgment or allegation of patent -infringement or for any other reason (not limited to patent issues), -conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot -distribute so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not distribute the Program at all. For example, if a patent -license would not permit royalty-free redistribution of the Program by -all those who receive copies directly or indirectly through you, then -the only way you could satisfy both it and this License would be to -refrain entirely from distribution of the Program. - -If any portion of this section is held invalid or unenforceable under -any particular circumstance, the balance of the section is intended to -apply and the section as a whole is intended to apply in other -circumstances. - -It is not the purpose of this section to induce you to infringe any -patents or other property right claims or to contest validity of any -such claims; this section has the sole purpose of protecting the -integrity of the free software distribution system, which is -implemented by public license practices. Many people have made -generous contributions to the wide range of software distributed -through that system in reliance on consistent application of that -system; it is up to the author/donor to decide if he or she is willing -to distribute software through any other system and a licensee cannot -impose that choice. - -This section is intended to make thoroughly clear what is believed to -be a consequence of the rest of this License. - - 8. If the distribution and/or use of the Program is restricted in -certain countries either by patents or by copyrighted interfaces, the -original copyright holder who places the Program under this License -may add an explicit geographical distribution limitation excluding -those countries, so that distribution is permitted only in or among -countries not thus excluded. In such case, this License incorporates -the limitation as if written in the body of this License. - - 9. The Free Software Foundation may publish revised and/or new versions -of the General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the Program -specifies a version number of this License which applies to it and "any -later version", you have the option of following the terms and conditions -either of that version or of any later version published by the Free -Software Foundation. If the Program does not specify a version number of -this License, you may choose any version ever published by the Free Software -Foundation. - - 10. If you wish to incorporate parts of the Program into other free -programs whose distribution conditions are different, write to the author -to ask for permission. For software which is copyrighted by the Free -Software Foundation, write to the Free Software Foundation; we sometimes -make exceptions for this. Our decision will be guided by the two goals -of preserving the free status of all derivatives of our free software and -of promoting the sharing and reuse of software generally. - - NO WARRANTY - - 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY -FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN -OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES -PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED -OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF -MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS -TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE -PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, -REPAIR OR CORRECTION. - - 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR -REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, -INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING -OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED -TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY -YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER -PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE -POSSIBILITY OF SUCH DAMAGES. - - END OF TERMS AND CONDITIONS - - Appendix: How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -convey the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) 19yy - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - -Also add information on how to contact you by electronic and paper mail. - -If the program is interactive, make it output a short notice like this -when it starts in an interactive mode: - - Gnomovision version 69, Copyright (C) 19yy name of author - Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, the commands you use may -be called something other than `show w' and `show c'; they could even be -mouse-clicks or menu items--whatever suits your program. - -You should also get your employer (if you work as a programmer) or your -school, if any, to sign a "copyright disclaimer" for the program, if -necessary. Here is a sample; alter the names: - - Yoyodyne, Inc., hereby disclaims all copyright interest in the program - `Gnomovision' (which makes passes at compilers) written by James Hacker. - - , 1 April 1989 - Ty Coon, President of Vice - -This General Public License does not permit incorporating your program into -proprietary programs. If your program is a subroutine library, you may -consider it more useful to permit linking proprietary applications with the -library. If this is what you want to do, use the GNU Library General -Public License instead of this License. diff --git a/Scripts/Documentation/Manpages/Locales/en_US/tcar-tuneup.asciidoc.po b/Scripts/Documentation/Manpages/Locales/en_US/tcar-tuneup.asciidoc.po new file mode 100644 index 0000000..b164488 --- /dev/null +++ b/Scripts/Documentation/Manpages/Locales/en_US/tcar-tuneup.asciidoc.po @@ -0,0 +1,392 @@ +msgid "" +msgstr "" +"Project-Id-Version: tuneup.asciidoc 0.6\n" +"POT-Creation-Date: 2013-11-07 15:18-0500\n" +"PO-Revision-Date: 2013-11-07 15:18-0500\n" +"Last-Translator: Localization SIG \n" +"Language-Team: English\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +msgid "tuneup" +msgstr "tuneup" + +msgid "1" +msgstr "1" + +msgid "" +"Standardizes source code maintenance tasks inside the repository." +msgstr "" +"Standardizes source code maintenance tasks inside the repository." + +msgid "centos-art.sh tuneup [FILE …|DIRECTORY …] [--filter=\"REGEX\"]" +msgstr "" +"centos-art.sh tuneup [FILE …|DIRECTORY …] [--filter=\"REGEX\"]" + +msgid "Execute source code maintenance tasks." +msgstr "Execute source code maintenance tasks." + +msgid "Description" +msgstr "Description" + +msgid "" +"When you run the tuneup module " +"it may enter into either file or directory processing, based on " +"whether you provide a file or directory as argument for processing " +"in the command-line. When you provide a file as argument to " +"tuneup module, it uses the " +"file's extension as reference for applying maintenance tasks on " +"that file as described in . When you provide a directory as argument, tuneup looks for all files with supported " +"extensions inside that directory and then process them, one by one." +msgstr "" +"When you run the tuneup module " +"it may enter into either file or directory processing, based on " +"whether you provide a file or directory as argument for processing " +"in the command-line. When you provide a file as argument to " +"tuneup module, it uses the " +"file's extension as reference for applying maintenance tasks on " +"that file as described in . When you provide a directory as argument, tuneup looks for all files with supported " +"extensions inside that directory and then process them, one by one." + +msgid "" +"The tuneup module exists to " +"automate frequent tasks related to code maintenance, inside the " +"repository (see ). It is advisable to " +"run tuneup module over your " +"files from time to time so they all have a common look and feel." +msgstr "" +"The tuneup module exists to " +"automate frequent tasks related to code maintenance, inside the " +"repository (see ). It is advisable to " +"run tuneup module over your " +"files from time to time so they all have a common look and feel." + +msgid "Supported File Extensions" +msgstr "Supported File Extensions" + +msgid "" +"The tuneup module supports " +"maintenance tasks for the following file extensions:" +msgstr "" +"The tuneup module supports " +"maintenance tasks for the following file extensions:" + +msgid ".svgz, .svg" +msgstr ".svgz, .svg" + +msgid "Provides maintenance tasks for Scalable Vector Graphics (SVG)." +msgstr "" +"Provides maintenance tasks for Scalable Vector Graphics (SVG)." + +msgid "" +"When processing svg files, tuneup uses the inkscape's --vaccumm option to cleanup source " +"code and applies few sed commands to modify inkscape's metadata " +"using dynamic information like document title, date, copyright " +"information, urls, and locale information retrieved from from " +"centos-art.sh script and the file location inside the repository." +msgstr "" +"When processing svg files, tuneup uses the inkscape's --vaccumm option to cleanup source " +"code and applies few sed commands to modify inkscape's metadata " +"using dynamic information like document title, date, copyright " +"information, urls, and locale information retrieved from from " +"centos-art.sh script and the file location inside the repository." + +msgid "" +"Each time you create a new svg file or change one, it is advisable " +"to run tuneup module over it." +msgstr "" +"Each time you create a new svg file or change one, it is advisable " +"to run tuneup module over it." + +msgid ".xhtml, .html, .htm" +msgstr ".xhtml, .html, .htm" + +msgid "" +"Provides maintenance tasks for HyperText Markup Language (HTML)." +msgstr "" +"Provides maintenance tasks for HyperText Markup Language (HTML)." + +msgid "" +"When processing html-like files, tuneup changes each file to create a table of contents for each " +"heading constructions (see below) first and then transforms the " +"(probably malformed) HTML markup into valid XHTML documents using " +"xmllint(1) program." +msgstr "" +"When processing html-like files, tuneup changes each file to create a table of contents for each " +"heading constructions (see below) first and then transforms the " +"(probably malformed) HTML markup into valid XHTML documents using " +"xmllint(1) program." + +msgid "" +"In order for tuneup to create " +"the table of contents correctly, the heading construction inside " +"the HTML document must comply the following restrictions:" +msgstr "" +"In order for tuneup to create " +"the table of contents correctly, the heading construction inside " +"the HTML document must comply the following restrictions:" + +msgid "Headings must have one of the following forms:" +msgstr "Headings must have one of the following forms:" + +#, no-wrap +msgid "" +"<h1><a name=\"\">Title</a></h1>\n" +"<h1><a href=\"\">Title</a></h1>\n" +"<h1><a name=\"\" href=\"\">Title</a></h1>" +msgstr "" +"<h1><a name=\"\">Title</a></h1>\n" +"<h1><a href=\"\">Title</a></h1>\n" +"<h1><a name=\"\" href=\"\">Title</a></h1>" + +msgid "" +"In these constructions, the heading level may vary from h1 to h6 " +"but the heading content (e.g., “Title”) must not be empty." +msgstr "" +"In these constructions, the heading level may vary from h1 to h6 " +"but the heading content (e.g., “Title”) must not be empty." + +msgid "" +"When producing table of contents through tuneup module, both `name' and `href' attributes in " +"the anchor element of each heading will be reset dynamically using " +"a md5 string. The md5 string used in these cases is based on the " +"heading content (i.e., the text shown as heading when the page is " +"rendered in a browser) and won't change until you change the " +"heading content and run tuneup " +"module over it again." +msgstr "" +"When producing table of contents through tuneup module, both `name' and `href' attributes in " +"the anchor element of each heading will be reset dynamically using " +"a md5 string. The md5 string used in these cases is based on the " +"heading content (i.e., the text shown as heading when the page is " +"rendered in a browser) and won't change until you change the " +"heading content and run tuneup " +"module over it again." + +msgid "" +"The final table of contents will be expanded wherever you set the " +"<div class=\"toc\"></div> HTML " +"construction as a line of its own inside the file being processed." +msgstr "" +"The final table of contents will be expanded wherever you set the " +"<div class=\"toc\"></div> HTML " +"construction as a line of its own inside the file being processed." + +msgid ".sh" +msgstr ".sh" + +msgid "Provides maintenance tasks for Bash scripts." +msgstr "Provides maintenance tasks for Bash scripts." + +msgid "" +"When processing sh files, tuneup changes the file to update the written by section, " +"copyright year and license information inside shell scripts' top " +"comment. Later, it corrects variable name's references to be all " +"written in upper-case between brackets (e.g.," +msgstr "" +"When processing sh files, tuneup changes the file to update the written by section, " +"copyright year and license information inside shell scripts' top " +"comment. Later, it corrects variable name's references to be all " +"written in upper-case between brackets (e.g.," + +msgid "" +"In order for tuneup module to " +"update the top comment of your shell scripts correctly, it is " +"necessary that your top comments have one written by line followed by a line of 70 number-sign (#) characters, " +"as illustrated in This is the basic " +"construction. Everything between the written by " +"line and the last line of 70 number-sign characters will be " +"replaced by tuneup module top-" +"comment template which includes people names, copyright and license " +"information. Everything else does remain untouched." +msgstr "" +"In order for tuneup module to " +"update the top comment of your shell scripts correctly, it is " +"necessary that your top comments have one written by line followed by a line of 70 number-sign (#) characters, " +"as illustrated in This is the basic " +"construction. Everything between the written by " +"line and the last line of 70 number-sign characters will be " +"replaced by tuneup module top-" +"comment template which includes people names, copyright and license " +"information. Everything else does remain untouched." + +msgid "Top-comment convention used by tuneup module." +msgstr "Top-comment convention used by tuneup module." + +#, no-wrap +msgid "" +"#!/bin/bash\n" +"######################################################################\n" +"#\n" +"# ${FILE}.sh -- ${DESCRIPTION}\n" +"#\n" +"# Written by:\n" +"#\n" +"######################################################################" +msgstr "" +"#!/bin/bash\n" +"######################################################################\n" +"#\n" +"# ${FILE}.sh -- ${DESCRIPTION}\n" +"#\n" +"# Written by:\n" +"#\n" +"######################################################################" + +msgid "Options" +msgstr "Options" + +msgid "--help" +msgstr "--help" + +msgid "Print module's documentation." +msgstr "Print module's documentation." + +msgid "--version" +msgstr "--version" + +msgid "Print module's version." +msgstr "Print module's version." + +msgid "--filter=\"REGEX\"" +msgstr "--filter=\"REGEX\"" + +msgid "" +"This option let you reduce the number of files you want to process " +"by applying a (POSIX-egrep) regular expression to the list of file " +"paths returned for processing. This option is specially useful when " +"you need to process files inside a directory structure based on a " +"specific name patterns." +msgstr "" +"This option let you reduce the number of files you want to process " +"by applying a (POSIX-egrep) regular expression to the list of file " +"paths returned for processing. This option is specially useful when " +"you need to process files inside a directory structure based on a " +"specific name patterns." + +msgid "Examples" +msgstr "Examples" + +msgid "centos-art.sh tuneup Automation/Scripts" +msgstr "centos-art.sh tuneup Automation/Scripts" + +msgid "" +"This command updates the top comment and variable name references " +"of all files inside the Automation/Scripts directory, recursively." +msgstr "" +"This command updates the top comment and variable name references " +"of all files inside the Automation/Scripts directory, recursively." + +msgid "centos-art.sh tuneup Automation/Scripts/tcar_printVersion.sh" +msgstr "centos-art.sh tuneup Automation/Scripts/tcar_printVersion.sh" + +msgid "" +"This commands updates the top comment and variable name references " +"inside the tcar_printVersion.sh file only." +msgstr "" +"This commands updates the top comment and variable name references " +"inside the tcar_printVersion.sh file only." + +msgid "" +"centos-art.sh tuneup Automation/Scripts --filter=\"tcar_print.+\\.sh" +"$\"" +msgstr "" +"centos-art.sh tuneup Automation/Scripts --filter=\"tcar_print.+\\.sh" +"$\"" + +msgid "" +"This command updates the top comment and variable name refrences " +"inside files which name only begins with “tcar_print” followed by " +"any character and ends with “.sh”. All other files won't be touched." +msgstr "" +"This command updates the top comment and variable name refrences " +"inside files which name only begins with “tcar_print” followed by " +"any character and ends with “.sh”. All other files won't be touched." + +msgid "Author" +msgstr "Author" + +msgid "" +"The tuneup module has received " +"contributions from the following people:" +msgstr "" +"The tuneup module has received " +"contributions from the following people:" + +msgid "" +"Alain Reguera Delgado, =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST=" +msgstr "" +"Alain Reguera Delgado, =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST=" + +msgid "Copyright" +msgstr "Copyright" + +msgid "" +"Copyright © =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= " +"=COPYRIGHT_HOLDER=" +msgstr "" +"Copyright © =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= " +"=COPYRIGHT_HOLDER=" + +msgid "" +"The tuneup module is free " +"software; you can redistribute it and/or modify it under the terms " +"of the GNU General Public License as published by the Free Software " +"Foundation; either version 2 of the License, or (at your option) " +"any later version." +msgstr "" +"The tuneup module is free " +"software; you can redistribute it and/or modify it under the terms " +"of the GNU General Public License as published by the Free Software " +"Foundation; either version 2 of the License, or (at your option) " +"any later version." + +msgid "" +"Tue tuneup module is " +"distributed in the hope that it will be useful, but WITHOUT ANY " +"WARRANTY; without even the implied warranty of MERCHANTABILITY or " +"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public " +"License for more details." +msgstr "" +"Tue tuneup module is " +"distributed in the hope that it will be useful, but WITHOUT ANY " +"WARRANTY; without even the implied warranty of MERCHANTABILITY or " +"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public " +"License for more details." + +msgid "" +"You should have received a copy of the GNU General Public License " +"along with this program; if not, write to the Free Software " +"Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA." +msgstr "" +"You should have received a copy of the GNU General Public License " +"along with this program; if not, write to the Free Software " +"Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA." + +msgid "See Also" +msgstr "See Also" + +msgid "centos-art.sh(1), xmllint(1)" +msgstr "centos-art.sh(1), xmllint(1)" + +#. Put one translator per line, in the form of NAME , YEAR1, YEAR2. +msgid "translator-credits" +msgstr "translator-credits" diff --git a/Scripts/Documentation/Manpages/tcar-tuneup.asciidoc b/Scripts/Documentation/Manpages/tcar-tuneup.asciidoc new file mode 100644 index 0000000..0b6bf71 --- /dev/null +++ b/Scripts/Documentation/Manpages/tcar-tuneup.asciidoc @@ -0,0 +1,195 @@ +tcar-tuneup(1) +============== + +Name +---- + +tcar-tuneup - Standardizes source code maintenance tasks inside the +repository. + +Synopsis +-------- + +*tcar tuneup [FILE ...|DIRECTORY ...] [--filter="REGEX"]*:: + Execute source code maintenance tasks. + +Description +----------- + +When you run the *tuneup* command it may enter into either file or +directory processing, based on whether you provide a file or directory +as argument for processing in the command-line. When you provide a +file as argument to *tuneup* module, it uses the file's extension as +reference for applying maintenance tasks on that file as described in +<>. When you provide a directory as +argument, *tuneup* looks for all files with supported extensions +inside that directory and then process them, one by one. + +The *tuneup* module exists to automate frequent tasks related to code +maintenance, inside the repository (see <>). It is advisable +to run *tuneup* module over your files from time to time so they all +have a common look and feel. + +[[supported-file-extensions]] +Supported File Extensions +------------------------- + +The *tuneup* module supports maintenance tasks for the following file +extensions: + +.svgz, .svg +~~~~~~~~~~~ + +Provides maintenance tasks for Scalable Vector Graphics (SVG). + +When processing svg files, *tuneup* uses the inkscape's --vaccumm +option to cleanup source code and applies few sed commands to modify +inkscape's metadata using dynamic information like document title, +date, copyright information, urls, and locale information retrieved +from from tcar.sh script and the file location inside the +repository. + +Each time you create a new svg file or change one, it is advisable to +run *tuneup* module over it. + +.xhtml, .html, .htm +~~~~~~~~~~~~~~~~~~~ + +Provides maintenance tasks for HyperText Markup Language (HTML). + +When processing html-like files, *tuneup* changes each file to create +a table of contents for each heading constructions (see below) first +and then transforms the (probably malformed) HTML markup into valid +XHTML documents using xmllint(1) program. + +In order for *tuneup* to create the table of contents correctly, the +heading construction inside the HTML document must comply the +following restrictions: + +1. Headings must have one of the following forms: ++ +---------------------------------------------------------------------- +

Title

+

Title

+

Title

+---------------------------------------------------------------------- ++ +In these constructions, the heading level may vary from h1 to h6 but +the heading content (e.g., ``Title'') must not be empty. + +When producing table of contents through *tuneup* module, both `name' +and `href' attributes in the anchor element of each heading will be +reset dynamically using a md5 string. The md5 string used in these +cases is based on the heading content (i.e., the text shown as heading +when the page is rendered in a browser) and won't change until you +change the heading content and run *tuneup* module over it again. + +The final table of contents will be expanded wherever you set the ++
+ HTML construction as a line of its own +inside the file being processed. + +.sh +~~~ + +Provides maintenance tasks for Bash scripts. + +When processing sh files, *tuneup* changes the file to update the +written by section, copyright year and license information inside +shell scripts' top comment. Later, it corrects variable name's +references to be all written in upper-case between brackets (e.g., +``${VARNAME}''). + +In order for *tuneup* module to update the top comment of your shell +scripts correctly, it is necessary that your top comments have one ++written by+ line followed by a line of 70 number-sign (\#) +characters, as illustrated in <> This is the basic +construction. Everything between the +written by+ line and the last +line of 70 number-sign characters will be replaced by *tuneup* module +top-comment template which includes people names, copyright and +license information. Everything else does remain untouched. + +[[top-comment]] +.Top-comment convention used by tuneup module. +====================================================================== +---------------------------------------------------------------------- +#!/bin/bash +###################################################################### +# +# ${FILE}.sh -- ${DESCRIPTION} +# +# Written by: +# +###################################################################### +---------------------------------------------------------------------- +====================================================================== + +[[options]] +Options +------- + +*--help*:: + Print module's documentation. +*--version*:: + Print module's version. +*--filter="REGEX"*:: + This option let you reduce the number of files you want to process + by applying a (POSIX-egrep) regular expression to the list of file + paths returned for processing. This option is specially useful + when you need to process files inside a directory structure based + on a specific name patterns. + +[[examples]] + +Examples +-------- + +*tcar.sh tuneup Automation/Scripts*:: + This command updates the top comment and variable name references + of all files inside the Automation/Scripts directory, recursively. + +*tcar.sh tuneup Automation/Scripts/tcar_printVersion.sh*:: + This commands updates the top comment and variable name references + inside the tcar_printVersion.sh file only. + +*tcar.sh tuneup Automation/Scripts --filter="tcar_print.+\.sh$"*:: + This command updates the top comment and variable name refrences + inside files which name only begins with ``tcar_print'' followed + by any character and ends with ``.sh''. All other files won't be + touched. + +[[author]] + +Author +------ + +Written by Alain Reguera Delgado + +[[copyright]] + +Copyright +--------- + +Copyright (C) =COPYRIGHT_YEAR_LAST= =COPYRIGHT_HOLDER= + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or (at +your option) any later version. + +This program is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +[[see-also]] + +See Also +-------- + +tcar.sh(1), xmllint(1) + +// vim: set syntax=asciidoc: diff --git a/Scripts/Documentation/Manpages/tcar-tuneup.conf b/Scripts/Documentation/Manpages/tcar-tuneup.conf new file mode 100644 index 0000000..2195c05 --- /dev/null +++ b/Scripts/Documentation/Manpages/tcar-tuneup.conf @@ -0,0 +1,7 @@ +[tcar-tuneup] +render-type = "asciidoc" +render-flow = "manpage" +render-from = "tcar-tuneup.asciidoc" +locale-from = "Locales/${TCAR_SCRIPT_LANG_LC}/tcar-tuneup.asciidoc.po" +formats = "xhtml manpage" +mansect = "1" diff --git a/Scripts/Locales/es_ES/tcar-tuneup.sh.po b/Scripts/Locales/es_ES/tcar-tuneup.sh.po new file mode 100644 index 0000000..72d358b --- /dev/null +++ b/Scripts/Locales/es_ES/tcar-tuneup.sh.po @@ -0,0 +1,16 @@ +msgid "" +msgstr "" +"Project-Id-Version: tuneup.sh 0.6\n" +"Report-Msgid-Bugs-To: centos-l10n-es@centos.org.cu\n" +"POT-Creation-Date: 2013-10-07 15:20-0400\n" +"PO-Revision-Date: 2013-10-07 15:20-0400\n" +"Last-Translator: Localization SIG \n" +"Language-Team: Spanish\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: Automation/Modules/Tuneup/tuneup.sh:50 +msgid "The argument provided isn't valid." +msgstr "El argumento suministado no es válido." diff --git a/Scripts/Modules/Tuneup/Modules/Sh/Configs/topcomment.sed b/Scripts/Modules/Tuneup/Modules/Sh/Configs/topcomment.sed new file mode 100755 index 0000000..2ecc33f --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Sh/Configs/topcomment.sed @@ -0,0 +1,53 @@ +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Define script first line. +1c\ +#!/bin/bash + +# This file standardizes the top comment inside tcar.sh scripts. +2i\ +######################################################################\ +#\ +# tcar - The CentOS Artwork Repository automation tool.\ +# Copyright © =COPYRIGHT_LAST_YEAR= =COPYRIGHT_HOLDER=\ +#\ +# This program is free software; you can redistribute it and/or\ +# modify it under the terms of the GNU General Public License as\ +# published by the Free Software Foundation; either version 2 of the\ +# License, or (at your option) any later version.\ +#\ +# This program is distributed in the hope that it will be useful,\ +# but WITHOUT ANY WARRANTY; without even the implied warranty of\ +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\ +# General Public License for more details.\ +#\ +# You should have received a copy of the GNU General Public License\ +# along with this program; if not, write to the Free Software\ +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.\ +#\ +# Alain Reguera Delgado \ +# 39 Street No. 4426 Cienfuegos, Cuba.\ +#\ +######################################################################\ diff --git a/Scripts/Modules/Tuneup/Modules/Sh/sh.sh b/Scripts/Modules/Tuneup/Modules/Sh/sh.sh new file mode 100755 index 0000000..cd12463 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Sh/sh.sh @@ -0,0 +1,31 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Standardize file maintenance for bash scripts. +function sh { + + sh_setTopComment + +} diff --git a/Scripts/Modules/Tuneup/Modules/Sh/sh_setTopComment.sh b/Scripts/Modules/Tuneup/Modules/Sh/sh_setTopComment.sh new file mode 100755 index 0000000..9279315 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Sh/sh_setTopComment.sh @@ -0,0 +1,46 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Standardize presentation for top comment section of shell scripts +# (*.sh) using a predefined template. +function sh_setTopComment { + + local COMMENT_TEMPLATE="${TCAR_MODULE_DIR_CONFIGS}/topcomment.sed" + + tcar_checkFiles -ef ${COMMENT_TEMPLATE} + + local COMMENT_INSTANCE=$(tcar_getTemporalFile ${COMMENT_TEMPLATE}) + + cp ${COMMENT_TEMPLATE} ${COMMENT_INSTANCE} + + tcar_setTranslationMarkers ${COMMENT_INSTANCE} + + sed -r -i -f ${COMMENT_INSTANCE} ${FILE} + + if [[ -f ${COMMENT_INSTANCE} ]];then + rm ${COMMENT_INSTANCE} + fi + +} diff --git a/Scripts/Modules/Tuneup/Modules/Svg/Configs/metadata.sed b/Scripts/Modules/Tuneup/Modules/Svg/Configs/metadata.sed new file mode 100755 index 0000000..d7bac07 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Svg/Configs/metadata.sed @@ -0,0 +1,85 @@ +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# This file is the metadata information used by The CentOS Artwork SIG +# on its scalable vector graphics (SVG) files. This files is used +# with the regular expression '.*\.svg$' only. +/\ + \ + \ + image/svg+xml\ + \ + \ + =TITLE=\ + =DATE=\ + \ + \ + =COPYRIGHT_HOLDER=\ + \ + \ + \ + \ + =COPYRIGHT_HOLDER=\ + \ + \ + \ + \ + =COPYRIGHT_HOLDER=\ + \ + \ + =URL=\ + =URL=\ + =URL=\ + =LOCALE=\ + \ + \ +=KEYWORDS=\ + \ + \ + =COPYRIGHT_HOLDER=\ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + diff --git a/Scripts/Modules/Tuneup/Modules/Svg/svg.sh b/Scripts/Modules/Tuneup/Modules/Svg/svg.sh new file mode 100755 index 0000000..f531ce9 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Svg/svg.sh @@ -0,0 +1,34 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Standardize source code maintenance of SVG files inside the +# repository. +function svg { + + svg_doMetadata + + svg_doVacuumDefs + +} diff --git a/Scripts/Modules/Tuneup/Modules/Svg/svg_setMetadata.sh b/Scripts/Modules/Tuneup/Modules/Svg/svg_setMetadata.sh new file mode 100755 index 0000000..63abea7 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Svg/svg_setMetadata.sh @@ -0,0 +1,91 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Update metadata values inside scalable vector graphic (SVG) files +# using default values from The CentOS Artwork SIG. +function svg_setMetadata { + + # Define template file name. + local TEMPLATE="${TCAR_MODULE_DIR_CONFIGS}/metadata.sed" + + # Check template file existence. + tcar_checkFiles -ef ${TEMPLATE} + + # Build title from file path. + local TITLE=$(basename "${FILE}") + + # Build url from file path. + local URL=$(echo ${FILE} \ + | sed 's!/home/centos!https://projects.centos.org/svn!') + + # Build keywords from file path. Do not include filename, it is + # already on title. + local KEY='' + local KEYS=$(dirname "${FILE}" | cut -d/ -f6- | tr '/' '\n') + + # Build keywords using SVG standard format. Note that this + # information is inserted inside template file. The template file + # is a replacement set of sed commands so we need to escape the + # new line of each line using one backslash (\). As we are doing + # this inside bash, it is required to escape the backslash with + # another backslash so one of them passes literally to template + # file. + KEYS=$(\ + for KEY in ${KEYS};do + echo " ${KEY}\\" + done) + + # Redefine template instance file name. + local INSTANCE=$(tcar_getTemporalFile ${TEMPLATE}) + + # Create instance. + cp ${TEMPLATE} ${INSTANCE} + + # Check template instance. We cannot continue if the template + # instance couldn't be created. + tcar_checkFiles -e ${INSTANCE} + + # Expand translation markers inside template instance. + sed -r -i \ + -e "s!=TITLE=!${TITLE}!" \ + -e "s!=URL=!${URL}!" \ + -e "s!=DATE=!$(date "+%Y-%m-%d")!" ${INSTANCE} + sed -i -r "/=KEYWORDS=/c\\${KEYS}" ${INSTANCE} + sed -i -r 's/>$/>\\/g' ${INSTANCE} + + tcar_setTranslationMarkers ${INSTANCE} + + # Update scalable vector graphic using template instance. + sed -i -f ${INSTANCE} ${FILE} + + # Remove template instance. + if [[ -f ${INSTANCE} ]];then + rm ${INSTANCE} + fi + + # Sanitate scalable vector graphic. + sed -i -r '/^[[:space:]]*$/d' ${FILE} + +} diff --git a/Scripts/Modules/Tuneup/Modules/Svg/svg_setVacuumDefs.sh b/Scripts/Modules/Tuneup/Modules/Svg/svg_setVacuumDefs.sh new file mode 100755 index 0000000..ba5db08 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Svg/svg_setVacuumDefs.sh @@ -0,0 +1,56 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +###################################################################### +# +# svg_setVacuumDefs.sh -- This function removes all unused items from +# the defs section of the SVG file. +# +# Written by: +# * Alain Reguera Delgado , 2009-2013 +# +# Copyright (C) 2009-2013 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or (at +# your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +###################################################################### + +function svg_setVacuumDefs { + + inkscape --vacuum-defs ${FILE} 2&> /dev/null + +} diff --git a/Scripts/Modules/Tuneup/Modules/Xhtml/Configs/toc.awk b/Scripts/Modules/Tuneup/Modules/Xhtml/Configs/toc.awk new file mode 100755 index 0000000..8ae32d6 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Xhtml/Configs/toc.awk @@ -0,0 +1,79 @@ +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# This file provides the output format required by `xhtml_setToc' +# function, inside centos-art.sh script, to produce the table of +# contents correctly. +BEGIN {FS=":"} + +{ + if ($1 == 0 && $2 == $3) { + opentags = "
" + closetags = "" + } + + if ($1 > 0 && $2 > $3) { + opentags = "
" + closetags = "" + } + + if ($1 > 0 && $2 == $3) { + opentags = "
" + closetags = "" + } + + if ($1 > 0 && $2 < $3) { + opentags = "" + for (i = 1; i <= ($3 - $2); i++) { + opentags = opentags "
" + closetags = "" + } + opentags = opentags "
" + } + + printf "%s%s%s\n",opentags,$4,closetags + +} + +END { + + if ($1 > 0 && $2 >= $3 && $3 > 1) { + for (i = 1; i <= $3; i++) { + print "
" + } + } + + if ($1 > 0 && $2 >= $3 && $3 == 1) { + print "" + print "" + } + + if ($1 > 0 && $2 < $3) { + for (i = 1; i <= $2; i++) { + print "" + } + } + + print "" +} diff --git a/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml.sh b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml.sh new file mode 100755 index 0000000..859ebe2 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml.sh @@ -0,0 +1,32 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Standardize maintenance tasks for HTML-like files. +function xhtml { + + xhtml_setToc + xhtml_setCleanUp + +} diff --git a/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setCleanUp.sh b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setCleanUp.sh new file mode 100755 index 0000000..f803acf --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setCleanUp.sh @@ -0,0 +1,41 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Create valid XHTML files from (probably malformed) HTML files. +function xhtml_setCleanUp { + + grep ' /dev/null \ + || egrep '\-//W3C//DTD XHTML 1.0 (Strict|Transitional)//EN' ${FILE} > /dev/null + if [[ $? -eq 0 ]];then + /usr/bin/xmllint --xmlout --format --noblanks \ + --nonet --nowarning \ + --output ${FILE} ${FILE} 2&> /dev/null + else + /usr/bin/xmllint --html --xmlout --format --noblanks \ + --nonet --nowarning \ + --output ${FILE} ${FILE} 2&> /dev/null + fi + +} diff --git a/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setToc.sh b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setToc.sh new file mode 100755 index 0000000..0e0e8c5 --- /dev/null +++ b/Scripts/Modules/Tuneup/Modules/Xhtml/xhtml_setToc.sh @@ -0,0 +1,161 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Transform web page headings to make them accessible through a table +# of contents. The table of contents is expanded in place, wherever +# the
piece of code be in the page. Once the +#
piece of code has be expanded, there is no +# need to put anything else in the page. +# +# In order for the tuneup functionality to transform headings, you +# need to put headings in just one line using one of the following +# forms: +# +#

Title

+#

Title

+#

Title

+# +# In the example above, h1 can vary from h1 to h6. Closing tag must be +# present and also match the openning tag. The value of `name' and +# `href' options from the anchor element are set dynamically using the +# md5sum output of combining the page location, the head- string and +# the heading string. +function xhtml_setToc { + + # Define variables as local to avoid conflicts outside. + local COUNT=0 + local PREVCOUNT=0 + local -a FINAL + local -a TITLE + local -a MD5SM + local -a OPTNS + local -a CLASS + local -a LEVEL + local -a PARENT + local -a TOCENTRIES + local -a LINK + + # Define table of content configuration file, the file used to + # produce the table of content XHTML output code. + local TOC_CONFIG=${TCAR_MODULE_DIR_CONFIGS}/toc.awk + + # Verify table of content configuration file. + tcar_checkFiles -ef ${TOC_CONFIG} + + # Define html heading regular expression pattern. Use parenthisis + # to save html action name, action value, and heading title. + local PATTERN='(]>)(.*[^<])' + + # Verify list of html files. Are files really html files? If they + # don't, continue with the next one in the list. + if [[ ! $(file --brief ${FILE}) =~ '^(XHTML|HTML|XML)' ]];then + continue + fi + + # Define list of headings to process. When building the heading, + # it is required to change spaces characters from its current + # decimal output to something different (e.g., its \040 octal + # alternative). This is required because the space character is + # used as egrep default field separator and spaces can be present + # inside heading strings we don't want to separate. + for HEADING in $(egrep "${PATTERN}" ${FILE} \ + | sed -r -e 's!^[[:space:]]+!!' -e "s! !\\\040!g");do + + # Define previous counter value using current counter + # value as reference. + if [[ ${COUNT} -ne 0 ]];then + PREVCOUNT=$((${COUNT}-1)) + fi + + # Define initial heading information. + FIRST[${COUNT}]=$(echo "${HEADING}" | sed -r "s!\\\040! !g") + TITLE[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\4!") + MD5SM[${COUNT}]=$(echo "${TITLE[${COUNT}]}" | md5sum | sed -r 's![[:space:]]+-$!!') + OPTNS[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\3!") + CLASS[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\2!") + LEVEL[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\1!") + PARENT[${COUNT}]=${LEVEL[${PREVCOUNT}]} + + # Transform heading information using initial heading + # information as reference. + if [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then + OPTNS[${COUNT}]='' + elif [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then + OPTNS[${COUNT}]='' + elif [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then + OPTNS[${COUNT}]='' + fi + + # Build final html heading structure. + FINAL[${COUNT}]=''${OPTNS[${COUNT}]}${TITLE[${COUNT}]}'' + + # Build html heading link structure. These links are used by + # the table of contents later. + LINK[${COUNT}]=''${TITLE[${COUNT}]}'' + + # Build table of contents entry with numerical + # identifications. The numerical identification is what we use + # to determine the correct position of each heading link on + # the table of content. + TOCENTRIES[${COUNT}]="${COUNT}:${LEVEL[${COUNT}]}:${PARENT[${COUNT}]}:${LINK[${COUNT}]}" + + # Update heading information inside the current file being + # processed. Use the first and final heading information. + sed -i -r "s!${FIRST[${COUNT}]}!${FINAL[${COUNT}]}!" ${FILE} + + # Increase heading counter. + COUNT=$((${COUNT} + 1)) + + done + + # Build the table of contents using heading numerical + # identifications as reference. The numerical identification + # describes the order of headings in one xhtml file. This + # information is processed by awk to make the appropriate + # replacements. Finnally, the result is stored in the TOC + # variable. + TOC=$(echo '
' + echo "

`gettext "Table of contents"`

" + for TOCENTRY in "${TOCENTRIES[@]}";do + echo ${TOCENTRY} + done \ + | awk -f ${TOC_CONFIG}) + + # Update table of contents inside the current file being + # processed. + sed -i -r '/
[^<\/div].*<\/div>/c'"$(echo -e ${TOC})" ${FILE} + + # Clean up variables to receive the next file. + unset FINAL + unset TITLE + unset MD5SM + unset OPTNS + unset CLASS + unset LEVEL + unset PARENT + unset TOCENTRIES + unset LINK + +} diff --git a/Scripts/Modules/Tuneup/tuneup.sh b/Scripts/Modules/Tuneup/tuneup.sh new file mode 100755 index 0000000..94e5b93 --- /dev/null +++ b/Scripts/Modules/Tuneup/tuneup.sh @@ -0,0 +1,74 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Standardize source files maintenance. +function tuneup { + + # Define file extensions tuneup module will look for processing. + local FILE_EXTENSION_REGEX='\.(svgz|svg|shtml|xhtml|html|sh)$' + + tuneup_getOptions + + for ARGUMENT in ${TCAR_MODULE_ARGUMENT};do + + # Sanitate non-option arguments to be sure they match the + # directory conventions established by tcar.sh script + # against source directory locations in the working copy. + local ARGUMENT=$(tcar_checkRepoDirSource ${ARGUMENT}) + + # Build list of files to process. + if [[ -f ${ARGUMENT} ]];then + local FILES=${ARGUMENT} + elif [[ -d ${ARGUMENT} ]];then + local FILES=$(tcar_getFilesList ${ARGUMENT} \ + --pattern=".+${FILE_EXTENSION_REGEX}" \ + --type='f' | egrep ${TCAR_FLAG_FILTER}) + else + tcar_printMessage "`gettext "The argument provided isn't valid."`" --as-error-line + fi + + # Process list of files. + for FILE in ${FILES};do + + # Print action message. + tcar_printMessage "${FILE}" --as-tuningup-line + + # Retrieve module name to apply based on file extension . + local FILE_EXTENSION=$(echo ${FILE} \ + | sed -r "s/.+${FILE_EXTENSION_REGEX}/\1/") + + # Set module aliases. + if [[ ${FILE_EXTENSION} =~ '(shtml|html|htm)' ]];then + FILE_EXTENSION='xhtml' + fi + + # Initiate module's environment for processing file. + tcar_setModuleEnvironment -m "${FILE_EXTENSION}" -t "child" "${FILE}" + + done + + done + +} diff --git a/Scripts/Modules/Tuneup/tuneup_getOptions.sh b/Scripts/Modules/Tuneup/tuneup_getOptions.sh new file mode 100755 index 0000000..1644d6d --- /dev/null +++ b/Scripts/Modules/Tuneup/tuneup_getOptions.sh @@ -0,0 +1,70 @@ +#!/bin/bash +###################################################################### +# +# tcar - The CentOS Artwork Repository automation tool. +# Copyright © 2014 The CentOS Artwork SIG +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation; either version 2 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +# +# Alain Reguera Delgado +# 39 Street No. 4426 Cienfuegos, Cuba. +# +###################################################################### + +# Initialize the command-line options used by tuneup module. +function tuneup_getOptions { + + # Define short options we want to support. + local ARGSS="h::,v,f:" + + # Define long options we want to support. + local ARGSL="help::,version,filter::" + + # Redefine arguments using getopt(1) command parser. + tcar_setModuleArguments + + # Reset positional parameters on this function, using output + # produced from (getopt) arguments parser. + eval set -- "${TCAR_MODULE_ARGUMENT}" + + # Look for options passed through command-line. + while true; do + case "${1}" in + + -h | --help ) + tcar_printHelp "${2}" + ;; + + -v | --version ) + tcar_printVersion "${TCAR_MODULE_NAME}" + ;; + + -f | --filter ) + TCAR_FLAG_FILTER="${2:-${TCAR_FLAG_FILTER}}" + shift 2 + ;; + + -- ) + shift 1 + break + ;; + esac + done + + # Redefine arguments using current positional parameters. Only + # paths should remain as arguments, at this point. + TCAR_MODULE_ARGUMENT="${@}" + +} diff --git a/tcar-scripts-tuneup-docs/Manpages/Locales/en_US/tuneup.asciidoc.po b/tcar-scripts-tuneup-docs/Manpages/Locales/en_US/tuneup.asciidoc.po deleted file mode 100644 index b164488..0000000 --- a/tcar-scripts-tuneup-docs/Manpages/Locales/en_US/tuneup.asciidoc.po +++ /dev/null @@ -1,392 +0,0 @@ -msgid "" -msgstr "" -"Project-Id-Version: tuneup.asciidoc 0.6\n" -"POT-Creation-Date: 2013-11-07 15:18-0500\n" -"PO-Revision-Date: 2013-11-07 15:18-0500\n" -"Last-Translator: Localization SIG \n" -"Language-Team: English\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=2; plural=(n != 1);\n" - -msgid "tuneup" -msgstr "tuneup" - -msgid "1" -msgstr "1" - -msgid "" -"Standardizes source code maintenance tasks inside the repository." -msgstr "" -"Standardizes source code maintenance tasks inside the repository." - -msgid "centos-art.sh tuneup [FILE …|DIRECTORY …] [--filter=\"REGEX\"]" -msgstr "" -"centos-art.sh tuneup [FILE …|DIRECTORY …] [--filter=\"REGEX\"]" - -msgid "Execute source code maintenance tasks." -msgstr "Execute source code maintenance tasks." - -msgid "Description" -msgstr "Description" - -msgid "" -"When you run the tuneup module " -"it may enter into either file or directory processing, based on " -"whether you provide a file or directory as argument for processing " -"in the command-line. When you provide a file as argument to " -"tuneup module, it uses the " -"file's extension as reference for applying maintenance tasks on " -"that file as described in . When you provide a directory as argument, tuneup looks for all files with supported " -"extensions inside that directory and then process them, one by one." -msgstr "" -"When you run the tuneup module " -"it may enter into either file or directory processing, based on " -"whether you provide a file or directory as argument for processing " -"in the command-line. When you provide a file as argument to " -"tuneup module, it uses the " -"file's extension as reference for applying maintenance tasks on " -"that file as described in . When you provide a directory as argument, tuneup looks for all files with supported " -"extensions inside that directory and then process them, one by one." - -msgid "" -"The tuneup module exists to " -"automate frequent tasks related to code maintenance, inside the " -"repository (see ). It is advisable to " -"run tuneup module over your " -"files from time to time so they all have a common look and feel." -msgstr "" -"The tuneup module exists to " -"automate frequent tasks related to code maintenance, inside the " -"repository (see ). It is advisable to " -"run tuneup module over your " -"files from time to time so they all have a common look and feel." - -msgid "Supported File Extensions" -msgstr "Supported File Extensions" - -msgid "" -"The tuneup module supports " -"maintenance tasks for the following file extensions:" -msgstr "" -"The tuneup module supports " -"maintenance tasks for the following file extensions:" - -msgid ".svgz, .svg" -msgstr ".svgz, .svg" - -msgid "Provides maintenance tasks for Scalable Vector Graphics (SVG)." -msgstr "" -"Provides maintenance tasks for Scalable Vector Graphics (SVG)." - -msgid "" -"When processing svg files, tuneup uses the inkscape's --vaccumm option to cleanup source " -"code and applies few sed commands to modify inkscape's metadata " -"using dynamic information like document title, date, copyright " -"information, urls, and locale information retrieved from from " -"centos-art.sh script and the file location inside the repository." -msgstr "" -"When processing svg files, tuneup uses the inkscape's --vaccumm option to cleanup source " -"code and applies few sed commands to modify inkscape's metadata " -"using dynamic information like document title, date, copyright " -"information, urls, and locale information retrieved from from " -"centos-art.sh script and the file location inside the repository." - -msgid "" -"Each time you create a new svg file or change one, it is advisable " -"to run tuneup module over it." -msgstr "" -"Each time you create a new svg file or change one, it is advisable " -"to run tuneup module over it." - -msgid ".xhtml, .html, .htm" -msgstr ".xhtml, .html, .htm" - -msgid "" -"Provides maintenance tasks for HyperText Markup Language (HTML)." -msgstr "" -"Provides maintenance tasks for HyperText Markup Language (HTML)." - -msgid "" -"When processing html-like files, tuneup changes each file to create a table of contents for each " -"heading constructions (see below) first and then transforms the " -"(probably malformed) HTML markup into valid XHTML documents using " -"xmllint(1) program." -msgstr "" -"When processing html-like files, tuneup changes each file to create a table of contents for each " -"heading constructions (see below) first and then transforms the " -"(probably malformed) HTML markup into valid XHTML documents using " -"xmllint(1) program." - -msgid "" -"In order for tuneup to create " -"the table of contents correctly, the heading construction inside " -"the HTML document must comply the following restrictions:" -msgstr "" -"In order for tuneup to create " -"the table of contents correctly, the heading construction inside " -"the HTML document must comply the following restrictions:" - -msgid "Headings must have one of the following forms:" -msgstr "Headings must have one of the following forms:" - -#, no-wrap -msgid "" -"<h1><a name=\"\">Title</a></h1>\n" -"<h1><a href=\"\">Title</a></h1>\n" -"<h1><a name=\"\" href=\"\">Title</a></h1>" -msgstr "" -"<h1><a name=\"\">Title</a></h1>\n" -"<h1><a href=\"\">Title</a></h1>\n" -"<h1><a name=\"\" href=\"\">Title</a></h1>" - -msgid "" -"In these constructions, the heading level may vary from h1 to h6 " -"but the heading content (e.g., “Title”) must not be empty." -msgstr "" -"In these constructions, the heading level may vary from h1 to h6 " -"but the heading content (e.g., “Title”) must not be empty." - -msgid "" -"When producing table of contents through tuneup module, both `name' and `href' attributes in " -"the anchor element of each heading will be reset dynamically using " -"a md5 string. The md5 string used in these cases is based on the " -"heading content (i.e., the text shown as heading when the page is " -"rendered in a browser) and won't change until you change the " -"heading content and run tuneup " -"module over it again." -msgstr "" -"When producing table of contents through tuneup module, both `name' and `href' attributes in " -"the anchor element of each heading will be reset dynamically using " -"a md5 string. The md5 string used in these cases is based on the " -"heading content (i.e., the text shown as heading when the page is " -"rendered in a browser) and won't change until you change the " -"heading content and run tuneup " -"module over it again." - -msgid "" -"The final table of contents will be expanded wherever you set the " -"<div class=\"toc\"></div> HTML " -"construction as a line of its own inside the file being processed." -msgstr "" -"The final table of contents will be expanded wherever you set the " -"<div class=\"toc\"></div> HTML " -"construction as a line of its own inside the file being processed." - -msgid ".sh" -msgstr ".sh" - -msgid "Provides maintenance tasks for Bash scripts." -msgstr "Provides maintenance tasks for Bash scripts." - -msgid "" -"When processing sh files, tuneup changes the file to update the written by section, " -"copyright year and license information inside shell scripts' top " -"comment. Later, it corrects variable name's references to be all " -"written in upper-case between brackets (e.g.," -msgstr "" -"When processing sh files, tuneup changes the file to update the written by section, " -"copyright year and license information inside shell scripts' top " -"comment. Later, it corrects variable name's references to be all " -"written in upper-case between brackets (e.g.," - -msgid "" -"In order for tuneup module to " -"update the top comment of your shell scripts correctly, it is " -"necessary that your top comments have one written by line followed by a line of 70 number-sign (#) characters, " -"as illustrated in This is the basic " -"construction. Everything between the written by " -"line and the last line of 70 number-sign characters will be " -"replaced by tuneup module top-" -"comment template which includes people names, copyright and license " -"information. Everything else does remain untouched." -msgstr "" -"In order for tuneup module to " -"update the top comment of your shell scripts correctly, it is " -"necessary that your top comments have one written by line followed by a line of 70 number-sign (#) characters, " -"as illustrated in This is the basic " -"construction. Everything between the written by " -"line and the last line of 70 number-sign characters will be " -"replaced by tuneup module top-" -"comment template which includes people names, copyright and license " -"information. Everything else does remain untouched." - -msgid "Top-comment convention used by tuneup module." -msgstr "Top-comment convention used by tuneup module." - -#, no-wrap -msgid "" -"#!/bin/bash\n" -"######################################################################\n" -"#\n" -"# ${FILE}.sh -- ${DESCRIPTION}\n" -"#\n" -"# Written by:\n" -"#\n" -"######################################################################" -msgstr "" -"#!/bin/bash\n" -"######################################################################\n" -"#\n" -"# ${FILE}.sh -- ${DESCRIPTION}\n" -"#\n" -"# Written by:\n" -"#\n" -"######################################################################" - -msgid "Options" -msgstr "Options" - -msgid "--help" -msgstr "--help" - -msgid "Print module's documentation." -msgstr "Print module's documentation." - -msgid "--version" -msgstr "--version" - -msgid "Print module's version." -msgstr "Print module's version." - -msgid "--filter=\"REGEX\"" -msgstr "--filter=\"REGEX\"" - -msgid "" -"This option let you reduce the number of files you want to process " -"by applying a (POSIX-egrep) regular expression to the list of file " -"paths returned for processing. This option is specially useful when " -"you need to process files inside a directory structure based on a " -"specific name patterns." -msgstr "" -"This option let you reduce the number of files you want to process " -"by applying a (POSIX-egrep) regular expression to the list of file " -"paths returned for processing. This option is specially useful when " -"you need to process files inside a directory structure based on a " -"specific name patterns." - -msgid "Examples" -msgstr "Examples" - -msgid "centos-art.sh tuneup Automation/Scripts" -msgstr "centos-art.sh tuneup Automation/Scripts" - -msgid "" -"This command updates the top comment and variable name references " -"of all files inside the Automation/Scripts directory, recursively." -msgstr "" -"This command updates the top comment and variable name references " -"of all files inside the Automation/Scripts directory, recursively." - -msgid "centos-art.sh tuneup Automation/Scripts/tcar_printVersion.sh" -msgstr "centos-art.sh tuneup Automation/Scripts/tcar_printVersion.sh" - -msgid "" -"This commands updates the top comment and variable name references " -"inside the tcar_printVersion.sh file only." -msgstr "" -"This commands updates the top comment and variable name references " -"inside the tcar_printVersion.sh file only." - -msgid "" -"centos-art.sh tuneup Automation/Scripts --filter=\"tcar_print.+\\.sh" -"$\"" -msgstr "" -"centos-art.sh tuneup Automation/Scripts --filter=\"tcar_print.+\\.sh" -"$\"" - -msgid "" -"This command updates the top comment and variable name refrences " -"inside files which name only begins with “tcar_print” followed by " -"any character and ends with “.sh”. All other files won't be touched." -msgstr "" -"This command updates the top comment and variable name refrences " -"inside files which name only begins with “tcar_print” followed by " -"any character and ends with “.sh”. All other files won't be touched." - -msgid "Author" -msgstr "Author" - -msgid "" -"The tuneup module has received " -"contributions from the following people:" -msgstr "" -"The tuneup module has received " -"contributions from the following people:" - -msgid "" -"Alain Reguera Delgado, =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST=" -msgstr "" -"Alain Reguera Delgado, =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST=" - -msgid "Copyright" -msgstr "Copyright" - -msgid "" -"Copyright © =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= " -"=COPYRIGHT_HOLDER=" -msgstr "" -"Copyright © =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= " -"=COPYRIGHT_HOLDER=" - -msgid "" -"The tuneup module is free " -"software; you can redistribute it and/or modify it under the terms " -"of the GNU General Public License as published by the Free Software " -"Foundation; either version 2 of the License, or (at your option) " -"any later version." -msgstr "" -"The tuneup module is free " -"software; you can redistribute it and/or modify it under the terms " -"of the GNU General Public License as published by the Free Software " -"Foundation; either version 2 of the License, or (at your option) " -"any later version." - -msgid "" -"Tue tuneup module is " -"distributed in the hope that it will be useful, but WITHOUT ANY " -"WARRANTY; without even the implied warranty of MERCHANTABILITY or " -"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public " -"License for more details." -msgstr "" -"Tue tuneup module is " -"distributed in the hope that it will be useful, but WITHOUT ANY " -"WARRANTY; without even the implied warranty of MERCHANTABILITY or " -"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public " -"License for more details." - -msgid "" -"You should have received a copy of the GNU General Public License " -"along with this program; if not, write to the Free Software " -"Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA." -msgstr "" -"You should have received a copy of the GNU General Public License " -"along with this program; if not, write to the Free Software " -"Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA." - -msgid "See Also" -msgstr "See Also" - -msgid "centos-art.sh(1), xmllint(1)" -msgstr "centos-art.sh(1), xmllint(1)" - -#. Put one translator per line, in the form of NAME , YEAR1, YEAR2. -msgid "translator-credits" -msgstr "translator-credits" diff --git a/tcar-scripts-tuneup-docs/Manpages/render.conf b/tcar-scripts-tuneup-docs/Manpages/render.conf deleted file mode 100644 index 3694c89..0000000 --- a/tcar-scripts-tuneup-docs/Manpages/render.conf +++ /dev/null @@ -1,7 +0,0 @@ -[tuneup] -render-type = "asciidoc" -render-flow = "manpage" -render-from = "tuneup.asciidoc" -locale-from = "Locales/${TCAR_SCRIPT_LANG_LC}/tuneup.asciidoc.po" -formats = "xhtml manpage" -mansect = "1" diff --git a/tcar-scripts-tuneup-docs/Manpages/tuneup.asciidoc b/tcar-scripts-tuneup-docs/Manpages/tuneup.asciidoc deleted file mode 100644 index bfe5edd..0000000 --- a/tcar-scripts-tuneup-docs/Manpages/tuneup.asciidoc +++ /dev/null @@ -1,198 +0,0 @@ -tuneup(1) -========= - -Name ----- - -tuneup - Standardizes source code maintenance tasks inside the -repository. - -Synopsis --------- - -*centos-art.sh tuneup [FILE ...|DIRECTORY ...] [--filter="REGEX"]*:: - Execute source code maintenance tasks. - -Description ------------ - -When you run the *tuneup* module it may enter into either file or -directory processing, based on whether you provide a file or directory -as argument for processing in the command-line. When you provide a -file as argument to *tuneup* module, it uses the file's extension as -reference for applying maintenance tasks on that file as described in -<>. When you provide a directory as -argument, *tuneup* looks for all files with supported extensions -inside that directory and then process them, one by one. - -The *tuneup* module exists to automate frequent tasks related to code -maintenance, inside the repository (see <>). It is advisable -to run *tuneup* module over your files from time to time so they all -have a common look and feel. - -[[supported-file-extensions]] -Supported File Extensions -------------------------- - -The *tuneup* module supports maintenance tasks for the following file -extensions: - -.svgz, .svg -~~~~~~~~~~~ - -Provides maintenance tasks for Scalable Vector Graphics (SVG). - -When processing svg files, *tuneup* uses the inkscape's --vaccumm -option to cleanup source code and applies few sed commands to modify -inkscape's metadata using dynamic information like document title, -date, copyright information, urls, and locale information retrieved -from from centos-art.sh script and the file location inside the -repository. - -Each time you create a new svg file or change one, it is advisable to -run *tuneup* module over it. - -.xhtml, .html, .htm -~~~~~~~~~~~~~~~~~~~ - -Provides maintenance tasks for HyperText Markup Language (HTML). - -When processing html-like files, *tuneup* changes each file to create -a table of contents for each heading constructions (see below) first -and then transforms the (probably malformed) HTML markup into valid -XHTML documents using xmllint(1) program. - -In order for *tuneup* to create the table of contents correctly, the -heading construction inside the HTML document must comply the -following restrictions: - -1. Headings must have one of the following forms: -+ ----------------------------------------------------------------------- -

Title

-

Title

-

Title

----------------------------------------------------------------------- -+ -In these constructions, the heading level may vary from h1 to h6 but -the heading content (e.g., ``Title'') must not be empty. - -When producing table of contents through *tuneup* module, both `name' -and `href' attributes in the anchor element of each heading will be -reset dynamically using a md5 string. The md5 string used in these -cases is based on the heading content (i.e., the text shown as heading -when the page is rendered in a browser) and won't change until you -change the heading content and run *tuneup* module over it again. - -The final table of contents will be expanded wherever you set the -+
+ HTML construction as a line of its own -inside the file being processed. - -.sh -~~~ - -Provides maintenance tasks for Bash scripts. - -When processing sh files, *tuneup* changes the file to update the -written by section, copyright year and license information inside -shell scripts' top comment. Later, it corrects variable name's -references to be all written in upper-case between brackets (e.g., -``${VARNAME}''). - -In order for *tuneup* module to update the top comment of your shell -scripts correctly, it is necessary that your top comments have one -+written by+ line followed by a line of 70 number-sign (\#) -characters, as illustrated in <> This is the basic -construction. Everything between the +written by+ line and the last -line of 70 number-sign characters will be replaced by *tuneup* module -top-comment template which includes people names, copyright and -license information. Everything else does remain untouched. - -[[top-comment]] -.Top-comment convention used by tuneup module. -====================================================================== ----------------------------------------------------------------------- -#!/bin/bash -###################################################################### -# -# ${FILE}.sh -- ${DESCRIPTION} -# -# Written by: -# -###################################################################### ----------------------------------------------------------------------- -====================================================================== - -[[options]] -Options -------- - -*--help*:: - Print module's documentation. -*--version*:: - Print module's version. -*--filter="REGEX"*:: - This option let you reduce the number of files you want to process - by applying a (POSIX-egrep) regular expression to the list of file - paths returned for processing. This option is specially useful - when you need to process files inside a directory structure based - on a specific name patterns. - -[[examples]] - -Examples --------- - -*centos-art.sh tuneup Automation/Scripts*:: - This command updates the top comment and variable name references - of all files inside the Automation/Scripts directory, recursively. - -*centos-art.sh tuneup Automation/Scripts/tcar_printVersion.sh*:: - This commands updates the top comment and variable name references - inside the tcar_printVersion.sh file only. - -*centos-art.sh tuneup Automation/Scripts --filter="tcar_print.+\.sh$"*:: - This command updates the top comment and variable name refrences - inside files which name only begins with ``tcar_print'' followed - by any character and ends with ``.sh''. All other files won't be - touched. - -[[author]] - -Author ------- - -The *tuneup* module has received contributions from the following -people: - - * mailto:al@centos.org.cu[Alain Reguera Delgado], =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= - -[[copyright]] - -Copyright ---------- - -Copyright (C) =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= =COPYRIGHT_HOLDER= - -The *tuneup* module is free software; you can redistribute it and/or -modify it under the terms of the GNU General Public License as -published by the Free Software Foundation; either version 2 of the -License, or (at your option) any later version. - -Tue *tuneup* module is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - -[[see-also]] - -See Also --------- - -centos-art.sh(1), xmllint(1) - -// vim: set syntax=asciidoc: diff --git a/tcar-scripts-tuneup/Locales/es_ES/tuneup.sh.po b/tcar-scripts-tuneup/Locales/es_ES/tuneup.sh.po deleted file mode 100644 index 72d358b..0000000 --- a/tcar-scripts-tuneup/Locales/es_ES/tuneup.sh.po +++ /dev/null @@ -1,16 +0,0 @@ -msgid "" -msgstr "" -"Project-Id-Version: tuneup.sh 0.6\n" -"Report-Msgid-Bugs-To: centos-l10n-es@centos.org.cu\n" -"POT-Creation-Date: 2013-10-07 15:20-0400\n" -"PO-Revision-Date: 2013-10-07 15:20-0400\n" -"Last-Translator: Localization SIG \n" -"Language-Team: Spanish\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=2; plural=(n != 1);\n" - -#: Automation/Modules/Tuneup/tuneup.sh:50 -msgid "The argument provided isn't valid." -msgstr "El argumento suministado no es válido." diff --git a/tcar-scripts-tuneup/Modules/Sh/Configs/topcomment.sed b/tcar-scripts-tuneup/Modules/Sh/Configs/topcomment.sed deleted file mode 100755 index a5fef74..0000000 --- a/tcar-scripts-tuneup/Modules/Sh/Configs/topcomment.sed +++ /dev/null @@ -1,57 +0,0 @@ -#!/bin/sed -###################################################################### -# -# topcomment.sed -- This file standardizes the top comment inside -# centos-art.sh scripts. -# -# Written by: -# * Alain Reguera Delgado -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### -/^#[[:space:]]*Written by:[[:space:]]*$/a\ -# Written by:\ -# * Alain Reguera Delgado , =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST=\ -#\ -# Copyright (C) =COPYRIGHT_YEAR_FIRST=-=COPYRIGHT_YEAR_LAST= =COPYRIGHT_HOLDER=\ -#\ -# This program is free software; you can redistribute it and/or modify\ -# it under the terms of the GNU General Public License as published by\ -# the Free Software Foundation; either version 2 of the License, or (at\ -# your option) any later version.\ -#\ -# This program is distributed in the hope that it will be useful, but\ -# WITHOUT ANY WARRANTY; without even the implied warranty of\ -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\ -# General Public License for more details.\ -#\ -# You should have received a copy of the GNU General Public License\ -# along with this program; if not, write to the Free Software\ -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.\ -#\ -###################################################################### - -# Remove previous copyright notice, just to be sure the one above be -# used always. -/^#[[:space:]]*Written by:[[:space:]]*$/,/^#{70}$/{ -d -} - -# Define script first line. -1c\ -#!/bin/bash diff --git a/tcar-scripts-tuneup/Modules/Sh/sh.sh b/tcar-scripts-tuneup/Modules/Sh/sh.sh deleted file mode 100755 index b9b4c2d..0000000 --- a/tcar-scripts-tuneup/Modules/Sh/sh.sh +++ /dev/null @@ -1,31 +0,0 @@ -#!/bin/bash -# -# sh.sh -- This module standardizes file Bash scripts maintenance -# tasks inside the repository. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function sh { - - sh_setTopComment - -} diff --git a/tcar-scripts-tuneup/Modules/Sh/sh_setTopComment.sh b/tcar-scripts-tuneup/Modules/Sh/sh_setTopComment.sh deleted file mode 100755 index 87c1314..0000000 --- a/tcar-scripts-tuneup/Modules/Sh/sh_setTopComment.sh +++ /dev/null @@ -1,44 +0,0 @@ -#!/bin/bash -###################################################################### -# -# sh_setTopComment.sh -- This function standardizes presentation for -# top comment section of shell scripts (*.sh) using a predefined -# template. -# -# Copyright (C) 2009-2013 The CentOS Project -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function sh_setTopComment { - - local COMMENT_TEMPLATE="${TCAR_MODULE_DIR_CONFIGS}/topcomment.sed" - - tcar_checkFiles -ef ${COMMENT_TEMPLATE} - - local COMMENT_INSTANCE=$(tcar_getTemporalFile ${COMMENT_TEMPLATE}) - - cp ${COMMENT_TEMPLATE} ${COMMENT_INSTANCE} - - tcar_setTranslationMarkers ${COMMENT_INSTANCE} - - sed -r -i -f ${COMMENT_INSTANCE} ${FILE} - - if [[ -f ${COMMENT_INSTANCE} ]];then - rm ${COMMENT_INSTANCE} - fi - -} diff --git a/tcar-scripts-tuneup/Modules/Svg/Configs/metadata.sed b/tcar-scripts-tuneup/Modules/Svg/Configs/metadata.sed deleted file mode 100755 index 199c44d..0000000 --- a/tcar-scripts-tuneup/Modules/Svg/Configs/metadata.sed +++ /dev/null @@ -1,64 +0,0 @@ -# This file is the metadata information used by CentOS Artwork SIG on -# its scalable vector graphics (SVG) files. This files is used with -# the regular expression '.*\.svg$' only. -# --------------------------------------------------- -# $Id$ -# --------------------------------------------------- -/\ - \ - \ - image/svg+xml\ - \ - \ - =TITLE=\ - =DATE=\ - \ - \ - =COPYRIGHT_HOLDER=\ - \ - \ - \ - \ - =COPYRIGHT_HOLDER=\ - \ - \ - \ - \ - =COPYRIGHT_HOLDER=\ - \ - \ - =URL=\ - =URL=\ - =URL=\ - =LOCALE=\ - \ - \ -=KEYWORDS=\ - \ - \ - =COPYRIGHT_HOLDER=\ - \ - \ - \ - \ - \ - \ - \ - \ - \ - \ - \ - \ - diff --git a/tcar-scripts-tuneup/Modules/Svg/svg.sh b/tcar-scripts-tuneup/Modules/Svg/svg.sh deleted file mode 100755 index b124cb0..0000000 --- a/tcar-scripts-tuneup/Modules/Svg/svg.sh +++ /dev/null @@ -1,34 +0,0 @@ -#!/bin/bash -###################################################################### -# -# svg.sh -- This module standardizes source code maintainance of SVG -# files inside the repository. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function svg { - - svg_doMetadata - - svg_doVacuumDefs - -} diff --git a/tcar-scripts-tuneup/Modules/Svg/svg_setMetadata.sh b/tcar-scripts-tuneup/Modules/Svg/svg_setMetadata.sh deleted file mode 100755 index ec897bd..0000000 --- a/tcar-scripts-tuneup/Modules/Svg/svg_setMetadata.sh +++ /dev/null @@ -1,92 +0,0 @@ -#!/bin/bash -###################################################################### -# -# svg_setMetadata.sh -- This function updates metadata values inside -# scalable vector graphic (SVG) files using default values from The -# CentOS Project. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function svg_setMetadata { - - # Define template file name. - local TEMPLATE="${TCAR_MODULE_DIR_CONFIGS}/metadata.sed" - - # Check template file existence. - tcar_checkFiles -ef ${TEMPLATE} - - # Build title from file path. - local TITLE=$(basename "${FILE}") - - # Build url from file path. - local URL=$(echo ${FILE} \ - | sed 's!/home/centos!https://projects.centos.org/svn!') - - # Build keywords from file path. Do not include filename, it is - # already on title. - local KEY='' - local KEYS=$(dirname "${FILE}" | cut -d/ -f6- | tr '/' '\n') - - # Build keywords using SVG standard format. Note that this - # information is inserted inside template file. The template file - # is a replacement set of sed commands so we need to escape the - # new line of each line using one backslash (\). As we are doing - # this inside bash, it is required to escape the backslash with - # another backslash so one of them passes literally to template - # file. - KEYS=$(\ - for KEY in ${KEYS};do - echo " ${KEY}\\" - done) - - # Redefine template instance file name. - local INSTANCE=$(tcar_getTemporalFile ${TEMPLATE}) - - # Create instance. - cp ${TEMPLATE} ${INSTANCE} - - # Check template instance. We cannot continue if the template - # instance couldn't be created. - tcar_checkFiles -e ${INSTANCE} - - # Expand translation markers inside template instance. - sed -r -i \ - -e "s!=TITLE=!${TITLE}!" \ - -e "s!=URL=!${URL}!" \ - -e "s!=DATE=!$(date "+%Y-%m-%d")!" ${INSTANCE} - sed -i -r "/=KEYWORDS=/c\\${KEYS}" ${INSTANCE} - sed -i -r 's/>$/>\\/g' ${INSTANCE} - - tcar_setTranslationMarkers ${INSTANCE} - - # Update scalable vector graphic using template instance. - sed -i -f ${INSTANCE} ${FILE} - - # Remove template instance. - if [[ -f ${INSTANCE} ]];then - rm ${INSTANCE} - fi - - # Sanitate scalable vector graphic. - sed -i -r '/^[[:space:]]*$/d' ${FILE} - -} diff --git a/tcar-scripts-tuneup/Modules/Svg/svg_setVacuumDefs.sh b/tcar-scripts-tuneup/Modules/Svg/svg_setVacuumDefs.sh deleted file mode 100755 index dae1648..0000000 --- a/tcar-scripts-tuneup/Modules/Svg/svg_setVacuumDefs.sh +++ /dev/null @@ -1,32 +0,0 @@ -#!/bin/bash -###################################################################### -# -# svg_setVacuumDefs.sh -- This function removes all unused items from -# the defs section of the SVG file. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function svg_setVacuumDefs { - - inkscape --vacuum-defs ${FILE} 2&> /dev/null - -} diff --git a/tcar-scripts-tuneup/Modules/Xhtml/Configs/toc.awk b/tcar-scripts-tuneup/Modules/Xhtml/Configs/toc.awk deleted file mode 100755 index ad47670..0000000 --- a/tcar-scripts-tuneup/Modules/Xhtml/Configs/toc.awk +++ /dev/null @@ -1,80 +0,0 @@ -#!/usr/bin/gawk -# -# toc.awk -- This file provides the output format required by -# `xhtml_setToc' function, inside centos-art.sh script, to produce -# the table of contents correctly. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Project -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Pubdtc License as pubdtshed by -# the Free Software Foundation; either version 2 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be usefdl, but -# WITHOUT ANY WARRANTY; without even the impdted warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Pubdtc License for more details. -# -# You shodld have received a copy of the GNU General Pubdtc License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 -# USA. -# -###################################################################### - -BEGIN {FS=":"} - -{ - if ($1 == 0 && $2 == $3) { - opentags = "
" - closetags = "" - } - - if ($1 > 0 && $2 > $3) { - opentags = "
" - closetags = "" - } - - if ($1 > 0 && $2 == $3) { - opentags = "
" - closetags = "" - } - - if ($1 > 0 && $2 < $3) { - opentags = "" - for (i = 1; i <= ($3 - $2); i++) { - opentags = opentags "
" - closetags = "" - } - opentags = opentags "
" - } - - printf "%s%s%s\n",opentags,$4,closetags - -} - -END { - - if ($1 > 0 && $2 >= $3 && $3 > 1) { - for (i = 1; i <= $3; i++) { - print "
" - } - } - - if ($1 > 0 && $2 >= $3 && $3 == 1) { - print "" - print "" - } - - if ($1 > 0 && $2 < $3) { - for (i = 1; i <= $2; i++) { - print "" - } - } - - print "
" -} diff --git a/tcar-scripts-tuneup/Modules/Xhtml/xhtml.sh b/tcar-scripts-tuneup/Modules/Xhtml/xhtml.sh deleted file mode 100755 index bb0207f..0000000 --- a/tcar-scripts-tuneup/Modules/Xhtml/xhtml.sh +++ /dev/null @@ -1,32 +0,0 @@ -#!/bin/bash -# -# xhtml.sh -- This function standardizes maintainance tasks for -# HTML-like files. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function xhtml { - - xhtml_setToc - xhtml_setCleanUp - -} diff --git a/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setCleanUp.sh b/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setCleanUp.sh deleted file mode 100755 index 95de440..0000000 --- a/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setCleanUp.sh +++ /dev/null @@ -1,42 +0,0 @@ -#!/bin/bash -###################################################################### -# -# xhtml_setCleanUp.sh -- This function creates valid XHTML files -# from (probably malformed) HTML files. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function xhtml_setCleanUp { - - grep ' /dev/null \ - || egrep '\-//W3C//DTD XHTML 1.0 (Strict|Transitional)//EN' ${FILE} > /dev/null - if [[ $? -eq 0 ]];then - /usr/bin/xmllint --xmlout --format --noblanks \ - --nonet --nowarning \ - --output ${FILE} ${FILE} 2&> /dev/null - else - /usr/bin/xmllint --html --xmlout --format --noblanks \ - --nonet --nowarning \ - --output ${FILE} ${FILE} 2&> /dev/null - fi - -} diff --git a/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setToc.sh b/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setToc.sh deleted file mode 100755 index e75a2b3..0000000 --- a/tcar-scripts-tuneup/Modules/Xhtml/xhtml_setToc.sh +++ /dev/null @@ -1,162 +0,0 @@ -#!/bin/bash -###################################################################### -# -# xhtml_setToc.sh -- This functionality transforms web page headings -# to make them accessible through a table of contents. The table of -# contents is expanded in place, wherever the
piece of code be in the page. Once the
piece of code has be expanded, there is no need -# to put anything else in the page. -# -# In order for the tuneup functionality to transform headings, you -# need to put headings in just one line using one of the following -# forms: -# -#

Title

-#

Title

-#

Title

-# -# In the example above, h1 can vary from h1 to h6. Closing tag must -# be present and also match the openning tag. The value of `name' -# and `href' options from the anchor element are set dynamically -# using the md5sum output of combining the page location, the head- -# string and the heading string. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function xhtml_setToc { - - # Define variables as local to avoid conflicts outside. - local COUNT=0 - local PREVCOUNT=0 - local -a FINAL - local -a TITLE - local -a MD5SM - local -a OPTNS - local -a CLASS - local -a LEVEL - local -a PARENT - local -a TOCENTRIES - local -a LINK - - # Define table of content configuration file, the file used to - # produce the table of content XHTML output code. - local TOC_CONFIG=${TCAR_MODULE_DIR_CONFIGS}/toc.awk - - # Verify table of content configuration file. - tcar_checkFiles -ef ${TOC_CONFIG} - - # Define html heading regular expression pattern. Use parenthisis - # to save html action name, action value, and heading title. - local PATTERN='(]>)(.*[^<])' - - # Verify list of html files. Are files really html files? If they - # don't, continue with the next one in the list. - if [[ ! $(file --brief ${FILE}) =~ '^(XHTML|HTML|XML)' ]];then - continue - fi - - # Define list of headings to process. When building the heading, - # it is required to change spaces characters from its current - # decimal output to something different (e.g., its \040 octal - # alternative). This is required because the space character is - # used as egrep default field separator and spaces can be present - # inside heading strings we don't want to separate. - for HEADING in $(egrep "${PATTERN}" ${FILE} \ - | sed -r -e 's!^[[:space:]]+!!' -e "s! !\\\040!g");do - - # Define previous counter value using current counter - # value as reference. - if [[ ${COUNT} -ne 0 ]];then - PREVCOUNT=$((${COUNT}-1)) - fi - - # Define initial heading information. - FIRST[${COUNT}]=$(echo "${HEADING}" | sed -r "s!\\\040! !g") - TITLE[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\4!") - MD5SM[${COUNT}]=$(echo "${TITLE[${COUNT}]}" | md5sum | sed -r 's![[:space:]]+-$!!') - OPTNS[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\3!") - CLASS[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\2!") - LEVEL[${COUNT}]=$(echo "${FIRST[${COUNT}]}" | sed -r "s!${PATTERN}!\1!") - PARENT[${COUNT}]=${LEVEL[${PREVCOUNT}]} - - # Transform heading information using initial heading - # information as reference. - if [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then - OPTNS[${COUNT}]='' - elif [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then - OPTNS[${COUNT}]='' - elif [[ ${OPTNS[${COUNT}]} =~ '^$' ]];then - OPTNS[${COUNT}]='' - fi - - # Build final html heading structure. - FINAL[${COUNT}]=''${OPTNS[${COUNT}]}${TITLE[${COUNT}]}'' - - # Build html heading link structure. These links are used by - # the table of contents later. - LINK[${COUNT}]=''${TITLE[${COUNT}]}'' - - # Build table of contents entry with numerical - # identifications. The numerical identification is what we use - # to determine the correct position of each heading link on - # the table of content. - TOCENTRIES[${COUNT}]="${COUNT}:${LEVEL[${COUNT}]}:${PARENT[${COUNT}]}:${LINK[${COUNT}]}" - - # Update heading information inside the current file being - # processed. Use the first and final heading information. - sed -i -r "s!${FIRST[${COUNT}]}!${FINAL[${COUNT}]}!" ${FILE} - - # Increase heading counter. - COUNT=$((${COUNT} + 1)) - - done - - # Build the table of contents using heading numerical - # identifications as reference. The numerical identification - # describes the order of headings in one xhtml file. This - # information is processed by awk to make the appropriate - # replacements. Finnally, the result is stored in the TOC - # variable. - TOC=$(echo '
' - echo "

`gettext "Table of contents"`

" - for TOCENTRY in "${TOCENTRIES[@]}";do - echo ${TOCENTRY} - done \ - | awk -f ${TOC_CONFIG}) - - # Update table of contents inside the current file being - # processed. - sed -i -r '/
[^<\/div].*<\/div>/c'"$(echo -e ${TOC})" ${FILE} - - # Clean up variables to receive the next file. - unset FINAL - unset TITLE - unset MD5SM - unset OPTNS - unset CLASS - unset LEVEL - unset PARENT - unset TOCENTRIES - unset LINK - -} diff --git a/tcar-scripts-tuneup/tuneup.sh b/tcar-scripts-tuneup/tuneup.sh deleted file mode 100755 index c1c55f7..0000000 --- a/tcar-scripts-tuneup/tuneup.sh +++ /dev/null @@ -1,75 +0,0 @@ -#!/bin/bash -###################################################################### -# -# tuneup.sh -- This module standardizes source code file -# maintainance inside the repository. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function tuneup { - - # Define file extensions tuneup module will look for processing. - local FILE_EXTENSION_REGEX='\.(svgz|svg|shtml|xhtml|html|sh)$' - - tuneup_getOptions - - for ARGUMENT in ${TCAR_MODULE_ARGUMENT};do - - # Sanitate non-option arguments to be sure they match the - # directory conventions established by centos-art.sh script - # against source directory locations in the working copy. - local ARGUMENT=$(tcar_checkRepoDirSource ${ARGUMENT}) - - # Build list of files to process. - if [[ -f ${ARGUMENT} ]];then - local FILES=${ARGUMENT} - elif [[ -d ${ARGUMENT} ]];then - local FILES=$(tcar_getFilesList ${ARGUMENT} \ - --pattern=".+${FILE_EXTENSION_REGEX}" \ - --type='f' | egrep ${TCAR_FLAG_FILTER}) - else - tcar_printMessage "`gettext "The argument provided isn't valid."`" --as-error-line - fi - - # Process list of files. - for FILE in ${FILES};do - - # Print action message. - tcar_printMessage "${FILE}" --as-tuningup-line - - # Retrieve module name to apply based on file extension . - local FILE_EXTENSION=$(echo ${FILE} \ - | sed -r "s/.+${FILE_EXTENSION_REGEX}/\1/") - - # Set module aliases. - if [[ ${FILE_EXTENSION} =~ '(shtml|html|htm)' ]];then - FILE_EXTENSION='xhtml' - fi - - # Initiate module's environment for processing file. - tcar_setModuleEnvironment -m "${FILE_EXTENSION}" -t "child" "${FILE}" - - done - - done - -} diff --git a/tcar-scripts-tuneup/tuneup_getOptions.sh b/tcar-scripts-tuneup/tuneup_getOptions.sh deleted file mode 100755 index 47bd426..0000000 --- a/tcar-scripts-tuneup/tuneup_getOptions.sh +++ /dev/null @@ -1,71 +0,0 @@ -#!/bin/bash -###################################################################### -# -# tuneup_getOptions.sh -- This file initialize the command-line -# options used by tuneup module. -# -# Written by: -# * Alain Reguera Delgado , 2009-2013 -# -# Copyright (C) 2009-2013 The CentOS Artwork SIG -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or (at -# your option) any later version. -# -# This program is distributed in the hope that it will be useful, but -# WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -# General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -# -###################################################################### - -function tuneup_getOptions { - - # Define short options we want to support. - local ARGSS="h::,v,f:" - - # Define long options we want to support. - local ARGSL="help::,version,filter::" - - # Redefine arguments using getopt(1) command parser. - tcar_setModuleArguments - - # Reset positional parameters on this function, using output - # produced from (getopt) arguments parser. - eval set -- "${TCAR_MODULE_ARGUMENT}" - - # Look for options passed through command-line. - while true; do - case "${1}" in - - -h | --help ) - tcar_printHelp "${2}" - ;; - - -v | --version ) - tcar_printVersion "${TCAR_MODULE_NAME}" - ;; - - -f | --filter ) - TCAR_FLAG_FILTER="${2:-${TCAR_FLAG_FILTER}}" - shift 2 - ;; - - -- ) - shift 1 - break - ;; - esac - done - - # Redefine arguments using current positional parameters. Only - # paths should remain as arguments, at this point. - TCAR_MODULE_ARGUMENT="${@}" - -}