User:Lvl/Devel/Distributed gettext fixing effort

From DPWiki
Jump to navigation Jump to search

Here is a list of files that remain to be checked for correct gettext markup.

Many of these files have already some kind of markup, but in most cases the markup is not done completely, or it was not done according to our best practices and therefore needs to be fixed or checked.

I'm giving the list in a rough priority order, but that should not prevent people for addressing the files in a different order. The priority here is arbitrary and has not been discussed or "approved".

Developers: Please edit this wiki page and mention on which files you will work. Here is the suggested way-ahead:

  1. before working on a file, add your name in front of the file you're considering for review, by inserting -- ~~~ (this is a special wiki syntax that will add your name).
  2. once you're finished fixing the gettext on this file:
    • for very simple changes, like small gettext() changes, it is acceptable to just lint-test the file to ensure that the syntax is correct, without going through the hoops of having the change be reviewed by another developer. Just lint (php -l) the php file after making the change and before committing.
    • on the other hand if fixing the gettext markup needed more complex changes, instead of "Done", put "needing review". Another developer will then coordinate with you to review your code, and put "Done" finally when the changes are reviewed and committed to CVS.


See also:


High priority

Login and general pages

  • accounts/activate.php -- Done. Lvl
  • accounts/addproofer.php -- Done. Lvl
  • accounts/login.php -- Done. Lvl
  • accounts/signin.php -- Checked OK. Lvl
  • activity_hub.php -- Done. Lvl
  • default.php -- Checked OK. Lvl
  • faq/faq_central.php
  • pinc/maintenance_mode.inc -- Checked OK. Lvl
  • pinc/prefs_options.inc -- Checked OK. Lvl
  • userprefs.php -- Done. Lvl
  • pinc/theme.inc -- Done. Lvl
  • pinc/ThemedTable.inc -- No translatable text. Lvl
  • pinc/site_specific.inc -- Done. Lvl
  • pinc/slim_header.inc -- No translatable text. Lvl
  • pinc/gradual.inc -- Checked OK. Lvl
  • pinc/username.inc -- Checked OK. Lvl

News

In order to have the site news display in the user's language, some additional logic must be designed.

  • pinc/site_news.inc -- Done. Lvl
  • list_etexts.php -- Checked OK. Lvl
  • pastnews.php -- Done. Lvl

Proofreading interface

  • tools/proofers/button_menu.inc -- Done. Lvl
  • tools/proofers/ctrl_frame.php -- Done. Lvl
  • tools/proofers/for_mentors.php -- Done. Lvl
  • tools/proofers/greek2ascii.php -- Done. Lvl
  • tools/proofers/images_index.php -- Done. Lvl
  • tools/proofers/image_block_enh.inc -- Done. Lvl
  • tools/proofers/image_frame_std.php -- No translatable text (except for the frame title which can be neglected). Lvl
  • tools/proofers/mktable.php -- hard (monolithic UTF-8 code. Latin-1 translation will fail.) Lvl
  • tools/proofers/my_projects.php -- Done. Lvl
  • tools/proofers/PPage.inc -- Done. Lvl
  • tools/proofers/processtext.php -- Checked OK. Lvl
  • tools/proofers/proof.php -- Done. Lvl
  • tools/proofers/proof_frame.inc -- Checked OK. Lvl
  • tools/proofers/proof_frame.php -- Done. Lvl
  • tools/proofers/proof_frame_enh.inc -- Checked OK. Lvl
  • tools/proofers/proof_frame_std.inc -- Checked OK. Lvl
  • tools/proofers/report_bad_page.php -- Done. Lvl
  • tools/proofers/review_work.php -- Done. Lvl
  • tools/proofers/round.php -- Done. Lvl
  • tools/proofers/spellcheck.inc -- Done. Lvl
  • tools/proofers/spellcheck_text.inc -- Done. Lvl
  • tools/proofers/srchrep.php -- Done. Lvl
  • tools/proofers/text_frame_std.inc -- Done. Lvl
  • tools/proofers/text_frame_std.php -- No translatable text. Lvl
  • tools/proofers/toolbox.inc -- Done. Lvl
  • pinc/button_defs.inc -- Done. Lvl
  • pinc/wordcheck_engine.inc -- Checked OK. Lvl
  • pinc/abort.inc -- Checked OK. Lvl
  • pinc/simple_proof_text.inc -- Checked OK. Lvl

Rounds and projects visible to the Proofreaders

  • tools/request_access.php -- Done. Lvl
  • tools/project_manager/detail_legend.inc -- Checked OK. Lvl
  • tools/project_manager/page_detail.php -- Checked OK. Lvl
  • tools/project_manager/page_table.inc -- Done. Lvl
  • project.php -- Done. Lvl [**project history only partly translated]
  • pinc/filter_project_list.inc -- Done. Lvl
  • tools/set_project_event_subs.php -- Checked OK. Lvl
  • pinc/special_colors.inc -- Done. Lvl [**note that special day names are not translated]
  • tools/project_manager/diff.php -- Done. Lvl

Forums

(ask Donovan and the other Squirrels.)

As we know, phpbb2 is no longer supported, but the language packs are still available via Ubuntu archives at least for the point version immediately prior to ours. I will look in to which packs are included (53 according to the package documentation) and update this once I have information to report.--donovan 08:32, 20 July 2010 (PDT)

From this post in Recent Additions: "phpBB2 Language Packs for Dutch, French, German, Italian, Portuguese and Spanish have been installed."

Smoothreading

  • pinc/showavailablebooks.inc -- Checked OK. Lvl
  • pinc/smoothread.inc -- Done. Lvl
  • tools/post_proofers/smooth_reading.php -- Checked OK. Lvl
  • tools/upload_text.php -- Checked OK. Lvl
  • pinc/page_header.inc -- Done. Lvl
  • pinc/Stage.inc -- Done. Lvl
  • pinc/stages.inc -- Checked OK. Lvl
  • tools/change_sr_commitment.php -- Done. Lvl

Medium priority

Quiz

The quiz need to be looked at first to see how to translate the quiz themselves. TODO: understand what is remaining to be done in Amy's quizzes. Translating the wizard interface itself is very low priority

  • quiz/generic/hints.php
  • quiz/generic/main.php
  • quiz/generic/orig.php
  • quiz/generic/proof.php
  • quiz/generic/returnfeed.php
  • quiz/generic/right.php
  • quiz/generic/wizard/checks.php
  • quiz/generic/wizard/general.php
  • quiz/generic/wizard/messages.php
  • quiz/generic/wizard/output.php
  • quiz/generic/wizard/start.php
  • quiz/small_theme.inc
  • quiz/start.php
  • quiz/tuts/tut1.php
  • quiz/tuts/tut2.php
  • quiz/tuts/tut3.php
  • quiz/tuts/tut4.php
  • quiz/tuts/tut5.php
  • pinc/Quiz.inc

Post-processing

  • tools/pool.php -- Checked OK. Lvl
  • pinc/Pool.inc -- No translateable strings. Lvl
  • tools/post_proofers/download_scannos.php -- Checked OK. Lvl
  • tools/post_proofers/postcomments.php -- Checked OK. Lvl
  • tools/post_proofers/ppv_report.php -- Done. Lvl [**$language and $difficulty_level not translated yet]

Member statistics

  • stats/members/mbr_list.php -- Done. Lvl
  • stats/members/mbr_xml.php -- Done. Lvl
  • stats/members/mdetail.php -- Checked OK. Lvl
  • stats/includes/member.inc -- Done. Lvl [**note: strings like "none" will need context added; number_format not localised]
  • stats/includes/team.inc -- Done. Lvl

Teams

  • stats/members/jointeam.php -- Checked OK. Lvl
  • stats/teams/new_team.php -- Done. Lvl
  • stats/teams/tdetail.php -- Done. Lvl
  • stats/teams/teams_xml.php -- No translatable strings (no need to translate XML file). Lvl
  • stats/teams/tedit.php -- Checked OK. Lvl
  • stats/teams/tlist.php -- Checked OK. Lvl

Project manager

  • tools/changestate.php -- Done. Lvl
  • tools/download_images.php -- Checked OK. Only error messages, which are untranslated. Lvl
  • tools/project_manager/add_files.php -- Done. Lvl
  • tools/project_manager/automodify.php -- Apparently only admin traces, not translated. Lvl [**emails to be translated later]
  • tools/project_manager/autorelease.inc -- Apparently only admin traces, not translated. Lvl [**emails to be translated later]
  • tools/project_manager/displayimage.php -- Done. Lvl
  • tools/project_manager/downloadproofed.php -- Checked OK. Only error messages, which are untranslated. Lvl
  • tools/project_manager/editproject.php -- Done. Lvl [**names of changed fields logged to project history not translated.]
  • tools/project_manager/edit_common.inc -- Done. Lvl
  • tools/project_manager/edit_pages.php -- Done. Lvl
  • tools/project_manager/external_catalog_search.php -- Done. Lvl [**language not translated; encoding issues with external results to be fixed later]
  • tools/project_manager/generate_post_files.php -- Only admin messages, not translated. Lvl
  • tools/project_manager/handle_bad_page.php -- Done. Lvl
  • tools/project_manager/page_operations.inc -- Checked OK. Lvl
  • tools/project_manager/post_files.inc -- No translateable strings. Lvl
  • tools/project_manager/projectmgr.inc -- Done. Lvl
  • tools/project_manager/projectmgr.php -- Done. Lvl [**difficulty letter, languages, special days dates not translated yet; translated genres not in alphabetic order in search widget]
  • tools/project_manager/replace_image.php -- Done. Lvl
  • tools/project_manager/show_specials.php -- Done. Lvl [**date not localised in ugly dpsql_dump_query() stuff.]

WordCheck for the PM

  • tools/project_manager/edit_project_word_lists.php -- Done. Lvl [**todo: language, link to wordcheck faq]
  • tools/project_manager/show_adhoc_word_details.php -- Done. Lvl
  • tools/project_manager/show_all_good_word_suggestions.php -- Checked OK. Lvl
  • tools/project_manager/show_current_flagged_words.php -- Checked OK. Lvl
  • tools/project_manager/show_good_word_suggestions.php -- Checked OK. Lvl
  • tools/project_manager/show_good_word_suggestions_detail.php -- Done. Lvl
  • tools/project_manager/show_project_possible_bad_words.php -- Checked OK. Lvl [**todo: in all these WordCheck scripts returning a file, mention the encoding in the header() function.]
  • tools/project_manager/show_project_stealth_scannos.php -- Checked OK. Lvl
  • tools/project_manager/show_project_wordcheck_stats.php -- Checked OK. Lvl
  • tools/project_manager/graph_flags_per_page.php -- Checked OK. Lvl [**todo: check possible encoding issues with these graphs]
  • tools/project_manager/graph_pages_per_number_of_flags.php -- Checked OK. Lvl
  • tools/project_manager/show_project_wordcheck_usage.php -- Checked OK. Lvl
  • tools/project_manager/show_word_context.php -- Done. Lvl
  • tools/project_manager/word_freq_table.inc -- Done. Lvl

Low priority

Site statistics

  • stats/checkedout.php -- Done. Lvl [** hand-concatenated date not translated; this is yet another project list that should preferably reuse existing code]
  • stats/misc_stats1.php -- Done. Lvl
  • stats/pm_stats.php -- Done. Lvl
  • stats/PPV_avail.php -- Done. Lvl [** same remarks as for stats/checkedout.php]
  • stats/ppv_stats.php -- Done. Lvl
  • stats/pp_stats.php -- Done. Lvl
  • stats/PP_unknown.php -- Checked OK. Lvl [** date via sql from_unixtime() not localised]
  • stats/proof_stats.php -- Done. Lvl
  • stats/release_queue.php -- Done. Lvl [** date via sql from_unixtime() not localised]
  • stats/requested_books.php -- Done. Lvl [** genre and language not translated: needs to replace current mysql_dump_query logic.]
  • stats/software.php -- Done. Lvl [** language names and logic to be improved]
  • stats/statestats.inc -- No translateable strings. Lvl
  • stats/stats_central.php -- Done. Lvl
  • stats/to_be_released.php -- Markup OK. Lvl [**date, language and genre not localised]

graphs

  • stats/jpgraph_files/average_hour_users_logging_on.php -- Checked OK. Lvl
  • stats/jpgraph_files/common.inc
  • stats/jpgraph_files/cumulative_month_proj.php
  • stats/jpgraph_files/cumulative_total_proj_graph.php
  • stats/jpgraph_files/cumulative_total_proj_summary_graph.php
  • stats/jpgraph_files/curr_month_proj.php
  • stats/jpgraph_files/pages_daily.php
  • stats/jpgraph_files/percent_users_who_proof.php
  • stats/jpgraph_files/tallyboard_deltas.php
  • stats/jpgraph_files/total_pages_by_month_graph.php
  • stats/jpgraph_files/total_proj_graph.php
  • stats/jpgraph_files/users_by_country.php
  • stats/jpgraph_files/users_by_language.php
  • stats/jpgraph_files/users_by_month_joined.php
  • stats/jpgraph_files/users_by_pages_proofed_graph.php
  • stats/jpgraph_files/users_logging_on.php
  • stats/misc_user_stats.php -- Checked OK. Lvl
  • stats/projects_Xed_graphs.php -- Checked OK. Lvl
  • stats/pages_proofed_graphs.php -- Checked OK. Lvl
  • stats/user_logon_stats.php -- Checked OK. Lvl

Internal utilities, to be translated according to the need

  • pinc/archiving.inc -- Not to be translated. Lvl
  • pinc/BrowseUtility.inc -- Checked OK. Lvl
  • pinc/dpsession_via_cookies.inc -- Checked OK. Lvl
  • pinc/dpsql.inc -- Done. Lvl
  • pinc/forum_interface.inc -- No translateable string. Lvl [** a few inefficient SELECT * queries]
  • pinc/list_projects.inc -- Checked OK. Lvl [** language not translated]
  • pinc/maybe_mail.inc -- Checked OK, but logic to be changed for email translation. Lvl
  • pinc/mentorbanner.inc -- Done. Lvl
  • pinc/metarefresh.inc -- Checked OK. Lvl
  • pinc/page_tally.inc -- No translateable string Lvl
  • pinc/phpbb2.inc -- Not to be translated. Lvl
  • pinc/ProjectTransition.inc -- Checked OK. Lvl [** emails, forum posts not translated.]
  • pinc/project_continuity.inc -- Checked OK. Lvl
  • pinc/project_events.inc -- No translateable string Lvl
  • pinc/project_edit.inc -- Done. Lvl
  • pinc/project_trans.inc -- Checked OK. Lvl
  • pinc/showstartexts.inc -- Checked OK, except for the alt attribute of image. Lvl
  • pinc/Stopwatch.inc -- No translateable string Lvl
  • pinc/tabs.inc -- No translateable string Lvl
  • pinc/TallyBoard.inc -- No translateable string Lvl
  • pinc/user_is.inc -- Checked OK. Lvl

Very Low Priority

Task center

We can translate the task center, but in any case the tasks themselves will have to be written in English to be understood by the admins.

  • tasks.php

Image source manager

  • tools/project_manager/show_image_sources.php -- Done. Lvl [**language, genre not translated in dpsql_dump]
  • tools/project_manager/manage_image_sources.php -- Done. Lvl [**emails not translated]

Translation center:

(this is the new translation center)

  • locale/translators/new_index.php -- Done. Lvl

Site admin

  • tools/site_admin/displayrandrules.php [** do be done later when implementing LOTE random rules]
  • tools/site_admin/edit_mail_address_for_non_activated_user.php -- Done . Lvl
  • tools/site_admin/insert_project.php
  • tools/site_admin/manage_site_word_lists.php
  • tools/site_admin/proj_approvals.php
  • tools/site_admin/rename_pages.php
  • tools/site_admin/shared_postednums.php
  • tools/site_admin/sitenews.php
  • tools/site_admin/stats_repair.php
  • tools/modify_access.php
  • tools/pending_access_requests.php -- Done . Lvl
  • config.php
  • stats/faq_data.php
  • tools/project_manager/move_projects.php -- Checked OK. Lvl

Files where only debug information is output

  • pinc/DPage.inc
  • pinc/SettingsClass.inc
  • pinc/LPage.inc
  • pinc/projectinfo.inc

FAQ files

No markup needed

For lengthy documents, we shall not use gettext but instead translate the entire document and manage a mapping from the english urls to the translation urls (at least that's my proposal)

  • faq/document.php
  • faq/formatting_guidelines_dutch.php
  • faq/formatting_guidelines_francaises.php
  • faq/formatting_guidelines_german.php
  • faq/formatting_guidelines_italian.php
  • faq/formatting_guidelines_portuguese.php
  • faq/dochist.php
  • faq/proofreading_guidelines.php
  • faq/proofreading_guidelines_dutch.php
  • faq/proofreading_guidelines_francaises.php
  • faq/proofreading_guidelines_german.php
  • faq/proofreading_guidelines_italian.php
  • faq/proofreading_guidelines_portuguese.php
  • faq/proofreading_guidelines_spanish.php
  • faq/cp.php
  • faq/pm-faq.php
  • faq/post_proof.php
  • faq/scanning.php
  • faq/dpf.php
  • faq/longabsent.php
  • faq/ppv.php
  • faq/ProoferFAQ.php
  • faq/wordcheck-faq.php -- TODO: move word list tables out of here.
  • faq/dev_process.php

To be gettexted

  • faq/font_sample.php
  • faq/simple_proof_rules.php
  • faq/site_progress_snapshot_legend.php


Needs to be implemented as PHP

Use gettext or handle translations as separate documents??

  • faq/privacy.php
  • faq/prooffacehelp.php


Not to be translated

  • faq/DPflow.php -- text is included in a picture
  • faq/templates_guide.php -- TODO: disentangle code, data and documentation
  • faq/feeds_sdk/index.php -- obsolete stuff?

Files where nothing is to be translated

(files which contain no English text):

  • tools/project_manager/DifferenceEngine.inc -- Lvl Done
  • tools/project_manager/DifferenceEngineWrapper.inc -- Lvl Done

cron jobs (no user interface)

  • crontab/archive_projects.php
  • crontab/del_teams.php
  • crontab/genthumbs.php
  • crontab/import_pg_catalog.php
  • crontab/inactivate_users.php
  • crontab/log_project_states.php
  • crontab/notify_old_pp.php
  • crontab/notify_users.php
  • crontab/onoff_special_event_queues.php
  • crontab/take_tally_snapshots.php
  • crontab/update_ppers.php
  • crontab/update_user_birthdays.php


Unused files

Code of dubious interest or status

  • tools/proofers/mentorclasses.inc
  • stats/temp_PM_stats.php
  • pinc/Profileclass.inc
  • pinc/Userclass.inc
  • sample/Usertest.php

Authors stuff

  • tools/authors/add.php
  • tools/authors/addbio.php
  • tools/authors/author.php
  • tools/authors/authors.inc
  • tools/authors/authorxml.php
  • tools/authors/bio.php
  • tools/authors/bioxml.php
  • tools/authors/harvest.php
  • tools/authors/listing.php
  • tools/authors/manage.php
  • tools/authors/menu.inc
  • tools/authors/search.inc

Currently unused code (potentially used later)

  • tools/proofers/md_available.php
  • tools/proofers/md_phase1.php
  • tools/proofers/md_phase2.php
  • tools/proofers/hiero/display.php
  • tools/proofers/hiero/index.php
  • tools/proofers/hiero/table.php

Unused code, to be moved to the attic or deleted

  • stats/statestats.php -- not linked from anywhere; obsolete (outputs data from november 2003!)
  • stats/renewals_status.php -- not linked from anywhere; specific and obsolete.
  • stats/currentstatestats.inc -- temporary hack that was never included anywhere.
  • stats/books/book_list.php -- not linked from anywhere, redundant with list_etexts.php
  • pinc/showtexts.inc -- only used by stats/books/book_list.php, and buggy.
  • stats/books/bdetail.php -- no longer linked from anywhere, and redundant.
  • stats/include/book.inc -- obsolete, only used by stats/books/bdetail.php
  • faq/doc-copy.php -- Guidelines for the copyright renewals projects
  • sample/shift_range.php
  • sample/tif2png.php
  • tools/catalog/get_page_text.php
  • tools/catalog/index.php
  • faq/download.php
  • tools/proofers/morenonascii.php
  • faq/translate.php -- old translation center
  • locale/translators/index.php
  • locale/translators/new_lang.php
  • locale/translators/save_po.php
  • tools/project_manager/edit_uberproject.php -- not linked from anywhere; broken.