{"id":1068,"date":"2010-01-12T17:50:00","date_gmt":"2010-01-12T17:50:00","guid":{"rendered":"http:\/\/hanif.de\/?p=1068"},"modified":"2022-10-23T23:38:09","modified_gmt":"2022-10-23T23:38:09","slug":"oq-editor","status":"publish","type":"post","link":"https:\/\/hanif.de\/?p=1068","title":{"rendered":"OQ Editor"},"content":{"rendered":"

\u0628\u0633\u0645 \u0627\u0644\u0644\u0647 \u0627\u0644\u0631\u062d\u0645\u0646 \u0627\u0644\u0631\u062d\u064a\u0645<\/big><\/span><\/p>\n

\"\"<\/p>\n

OQ-Editor<\/strong> is specially programmed to design oq-code which is used in OpenQuran since version 1.9.10.
\nWith oq code users can automate almost every method which is used in OpenQuran and even call hidden methods such as downloading files und playing Mp3 audio files.<\/p>\n

OQ Editor contains (on the right side of it) all methods in an easy to learn syntax. We can call any method by double clicking the method name from the list and modify it the way we want to.
\nThere\u2019s also a download manager, Mp3 player, Html Designer for nice formatted comments and an easy debugger to test the code.<\/p>\n

\"\"<\/a><\/p>\n

See some examples:<\/p>\n

    \n
  1. Die Basmalah<\/a><\/li>\n
  2. Saad Buchstabe<\/a><\/li>\n<\/ol>\n\n\n\n
    The Navigation Window <\/span><\/big><\/span><\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    The first line of oq code must begin with the syntax:
    \nuse oq code;<\/span><\/p>\n

    \"\"<\/p>\n

    OQ Code runs inside the NAV-Box of OpenQuran. That\u00b4s why its important to make difference between NAV function which consist of viewing verses by typing verse numbers beside some comments and the functions to OQ-Code.
    \nBy starting with the first method “use oq code<\/span>” the navigation window will appear and run the code one command after the other.<\/p>\n

    To test these 2 differences, first we type (or copy \/ paste) the following code in the NAV Box:<\/p><\/blockquote>\n

      \n
    1. (This how to use the Nav Box
      \nI would like to show you the verses from 1 to 3 of sura number 1) 1:1-3 (The rest of this Sura are the verses 4 to 7) 1:4-7<\/li>\n
    2. use oq code;<\/span>
      \nmessagebox: <\/span>The following code will select the quran table of openquran database,
      \nIf you still don\u00b4t have this table the code will download it for you and install it.
      \nBut if you already have it the code will skip the download and installation;
      \ndownload: <\/span>http:\/\/openquran.de\/download\/quran.txt;
      \ntxt to data: <\/span>quran.txt;
      \nmessagebox: <\/span>Ok, now we r sure, that you have the table “quran”
      \nThe next step is selecting this table from the Translations Tab, select sura number 1 to 3 and show them in the browser;
      \nselect translation:<\/span> quran;
      \nshow basmalah;<\/span>
      \nselect sura number:<\/span> 1-3;
      \nshow selected sura;<\/span><\/li>\n<\/ol>\n

      As we can see: the first code which handles only comments and verses, is running without the navigation window and the second code opens the navigation window to show and run all commands.
      \nOQ Code can be saved in *.oq files for own purpose or to share with other users. This way we can prevent Tutorials and Explanations for many themes, Teach quran spelling with running audio mp3 files, share translations and many other things.<\/p><\/blockquote>\n

       <\/p>\n\n\n\n
      Commands:<\/span><\/big><\/strong><\/span><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

       <\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Command<\/strong><\/td>\nExplanation<\/strong><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      use_oq_code;<\/span><\/td>\nThe first line of oq code must begin with this syntax:
      \nuse_oq_code;<\/span><\/td>\n<\/tr>\n
      (\u2026) [<\/span>1:1-7<\/span>]<\/span><\/td>\nView Comments and verses in the browser:
      \n(My comment) [<\/span>1:1<\/span>];<\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      show_basmalah: <\/span>yes<\/span> | no<\/span>;<\/td>\nInclude Basmalahs by viewing suras or by searches
      \nshow_basmalah: yes; <\/span><\/td>\n<\/tr>\n
      sura_info:<\/span> yes<\/span> | no<\/span>;<\/td>\nInclude sura info by viewing suras
      \nsura_info: yes; <\/span><\/td>\n<\/tr>\n
      go_backward;<\/span><\/td>\nGo backward function of the browser<\/td>\n<\/tr>\n
      go_forward;<\/span><\/td>\nGo forward function of the browser<\/td>\n<\/tr>\n
      select_all_text;<\/span><\/td>\nSelecting all text in the browser<\/td>\n<\/tr>\n
      sort_verse_numbers; <\/span><\/td>\nseparate and view only verse numbers from the browser content<\/td>\n<\/tr>\n
      sort_only_text; <\/span><\/td>\nseparate and view only the text from the browser content without the numbers<\/td>\n<\/tr>\n
      gematrical_value_from: selection; <\/span><\/td>\nSelects whole content of the browser and gets the gematrical value of the text<\/td>\n<\/tr>\n
      gematrical_value_from: <\/span>myWord; <\/span><\/td>\ngets the gematrical value of a given letter\/word\/phrase
      \ngematrical_value_from: <\/span>\u0631\u0641\u064a\u0639<\/span>; <\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      stop; <\/span><\/td>\nStops code and reset to start<\/td>\n<\/tr>\n
      pause: <\/span>1<\/span>; <\/span><\/td>\nPause the code in seconds (e.g. pause the code and run after 3 seconds):
      \npause: <\/span>3<\/span>; <\/span><\/td>\n<\/tr>\n
      messagebox: <\/span>yourText;<\/span><\/td>\nA messageBox with OK-Button for necessary hints
      \nmessagebox: <\/span>Press play Button to start the tutorial<\/span>; <\/span><\/td>\n<\/tr>\n
      openquran_info;<\/span><\/td>\nRuns the info window of OpenQuran<\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      select_sura_number: <\/span>setNumber\/s; <\/span><\/td>\nSelect specified sura numbers:
      \nselect sura number: <\/span>1 3 5 7<\/span>;<\/span>
      \nor make a range of specified sura numbers:
      \nselect sura number: <\/span>1-9<\/span>;<\/span><\/td>\n<\/tr>\n
      select_initialed_suras; <\/span><\/td>\nSelect suras which begin with special initial letters<\/td>\n<\/tr>\n
      select_uninitialed_suras; <\/span><\/td>\nSelect suras which have no special initial Letters<\/td>\n<\/tr>\n
      select_meccan_suras;<\/span><\/td>\nSelect suras which revealed in mecca<\/td>\n<\/tr>\n
      select_medinan_suras; <\/span><\/td>\nSelect suras which revealed in medina<\/td>\n<\/tr>\n
      select_odd_suras;<\/span><\/td>\nSelect odd numbered suras<\/td>\n<\/tr>\n
      select_even_suras;<\/span><\/td>\nSelect even numbered suras<\/td>\n<\/tr>\n
      show_selected_sura; <\/span><\/td>\nAfter selection we can run to view the chosen sura numbers<\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      searchbox: <\/span>word; <\/span><\/p>\n

       <\/td>\n

      		Send a letter\/word\/phrase to the searchBox
      \nsearchbox<\/span>: <\/span>\u0635<\/span>; <\/span><\/td>\n<\/tr>\n
      run_search;<\/span><\/td>\nRuns the normal search method<\/td>\n<\/tr>\n
      run_analyze;<\/span><\/td>\nRuns the analyses search method<\/td>\n<\/tr>\n
      search_options: <\/span>Method;<\/span><\/td>\nThere are 7 methods for the search options to define:<\/p>\n
        \n
      1. browser_content<\/span>: Selects the checkBox “Browser content<\/strong>” in the search option tab<\/li>\n
      2. whole_quran<\/span>: Selects 1 checkBox “Whole Quran<\/strong> ” in the search option tab<\/li>\n
      3. only_selected_suras<\/span>: Selects the checkBox “Only selected suras<\/strong> ” in the search option tab<\/li>\n
      4. match_word<\/span>: Selects the checkBox “Match word<\/strong> ” in the search option tab<\/li>\n
      5. case_sensitive<\/span>: Selects the checkBox “Case sensitive<\/strong> ” in the search option tab<\/li>\n
      6. regular_expressions<\/span>: Selects the checkBox “Regular Expressions<\/strong> ” in the search option tab<\/li>\n
      7. clear<\/span>: Clears selection of Regular Expressions<\/li>\n<\/ol>\n<\/td>\n<\/tr>\n
      count_search: <\/span>word = <\/span>2;<\/span><\/td>\nSearches for letter\/word\/phrase which occurs exactly like the given amount in every verse:
      \ncount_search<\/span>:\u0643=<\/span>2<\/span>; <\/span><\/td>\n<\/tr>\n
      count_search: <\/span>word > <\/span>2;<\/span><\/td>\nSearches for letter\/word\/phrase which occurs more than the given amount in every verse:
      \ncount_search<\/span>:\u0627\u0644><\/span>7<\/span>; <\/span><\/td>\n<\/tr>\n
      count_search: <\/span>word < <\/span>2; <\/span><\/td>\nSearches for letter\/word\/phrase which occurs lesser than the given amount in every verse:
      \ncount_search:<\/span>\u0627\u0644<<\/span>7<\/span>; <\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      send_to_calc: <\/span>Numbers; <\/span><\/p>\n

       <\/td>\n

      		Sends any number to the calculator box:
      \nsend_to_calculator:<\/span> 1234567890<\/span>; <\/span><\/td>\n<\/tr>\n
      send_to_calc: selection; <\/span><\/td>\nsends the browser content to the calculator<\/td>\n<\/tr>\n
      calc_options: <\/span>Method;<\/span><\/td>\nThere are 6 methods for the calc options to define:<\/p>\n
        \n
      1. clear<\/span>: Uncheck all selected options for the calculator<\/li>\n
      2. only_sura_numbers<\/span>: Select this option to calculate only sura numbers:
        \n1<\/span>:1 2<\/span>:1 3<\/span>:4 4<\/span>:6 \u2026.<\/li>\n
      3. only_verse_numbers<\/span>: Select this option to calculate only verse numbers:
        \n1:1<\/span> 2:1<\/span> 3:4<\/span> 4:6<\/span> \u2026.<\/li>\n
      4. set_counts_before<\/span>: Select this option to set a sequence number beginning with 1 before every verse or sura:
        \n1<\/span>1 2<\/span>1 3<\/span>4 4<\/span>6 \u2026.<\/li>\n
      5. set_counts_after<\/span>: Select this option to set a sequence number begriming with 1 after every verse or sura:
        \n11<\/span> 12<\/span> 43<\/span> 64<\/span> \u2026.<\/li>\n
      6. calc_options: usual;<\/span> Select this option to use the calc for usual calculations such as:
        \n1+2+3-2*2+6*2<\/span> \/\/ Resul 14 <\/span><\/li>\n<\/ol>\n<\/td>\n<\/tr>\n
      run_calculator: <\/span>R<\/span>;<\/span><\/td>\nRuns the calculation with one of the 5 methods
      \n+<\/span> (Plus)<\/em>
      \n–<\/span> (Minus)<\/em>
      \n*<\/span> (Multiplication)<\/em>
      \n\/<\/span> (Division)<\/em>
      \nR<\/span> (Remainder) <\/em>
      \nrun_calculator<\/span>: *; <\/span><\/td>\n<\/tr>\n
      set_divider_to: <\/span>19;<\/span><\/td>\nThe default number for calculations in OpenQuran is 19. We can change it to what ever we want:
      \nset_divider_to<\/span>: <\/span>7<\/span>; <\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      if_no_file: <\/span>fileName;<\/span><\/td>\nCheck out if the file exists by the user:
      \nif_no_file<\/span>: <\/span>myAudioFile.mp3<\/span>; <\/span><\/td>\n<\/tr>\n
      download: <\/span>Url;<\/span><\/td>\nIf the condition “if no file” is true, we can prevent the url of the file to download
      \ndownload<\/span>: <\/span>http:\/\/www.openquran.de\/myAudioFile.mp3<\/span>;<\/span>
      \nThe downloaded file will be saved in the folder “downloads” of openquran<\/td>\n<\/tr>\n
      save_as: <\/span>fileName;<\/span><\/td>\nWe can give the file a specified name to make it unique in the users folder “downloads” of “openquran”:
      \nsave_as<\/span>:<\/span> openquran001.mp3<\/span>; <\/span><\/td>\n<\/tr>\n
      open_oq: <\/span>fileName;<\/span><\/td>\nClose current navigation window and opens a new one with the defined file. The defined file has to be an *.oq file and exists in the folder “downloads” of openquran:
      \nopen_oq<\/span>: <\/span>next_Tutorial.oq<\/span>;<\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      play_audio: <\/span>audioFileName;<\/span><\/td>\nRuns the audio file:
      \nplay_audio<\/span>: <\/span>openquran001.mp3<\/span>; <\/span><\/td>\n<\/tr>\n
      pause_audio;<\/span><\/td>\nPauses audio file<\/td>\n<\/tr>\n
      stop_audio;<\/span><\/td>\nStops the audio file and resets to start<\/td>\n<\/tr>\n
      if_audio_position: <\/span>setNumber;<\/span><\/td>\nA condition to run any command when the playing audio file reaches a specified position
      \nif_audio_position<\/span>: <\/span>6555<\/span>; <\/span>[<\/span>1:1<\/span>];<\/span>
      \nThis will view verse 1:1 when the audio reaches position 6555<\/td>\n<\/tr>\n
      set_audio_position: <\/span>setNumber;<\/span><\/td>\nAfter the command “play audio” we can jump at a specified position:
      \nplay_audio<\/span>: <\/span>openquran001.mp3<\/span>; <\/span>
      \nset_audio_position<\/span>: <\/span>19355<\/span>; <\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      if_no_translation: <\/span>translationName;<\/span><\/td>\nCheck if the user has the translation we need
      \nif_no_translation<\/span>: <\/span>quran<\/span>; <\/span>
      \ndownload<\/span>: <\/span>http:\/\/openquran.de\/download\/quran.txt<\/span>; <\/span><\/td>\n<\/tr>\n
      txt_to_data: <\/span>translationFile;<\/span><\/td>\nInclude the translation file to the database of the user:
      \ntxt_to_data<\/span>: <\/span>quran.txt<\/span>; <\/span><\/td>\n<\/tr>\n
      select_translation: <\/span>translationName;<\/span><\/td>\nIf the user has the translation we require, we can unselect all others and leave only this one selected:
      \nselect_translation<\/span>:<\/span> quran<\/span>;<\/span><\/td>\n<\/tr>\n
      <\/td>\n<\/tr>\n
      commandsDefinition<\/span>[<\/span>int<\/span>]{<\/span> \u2026. } <\/span><\/td>\nWith this function we can define many commands and give them a specified number. This way we can add this bunch of commands when ever we need them by calling “commandNr<\/span>” with its function number:
      \ncommandsDefinition<\/span>[<\/span>1<\/span>]{ <\/span>
      \nsearch_options<\/span>: clear<\/span>;
      \nsearch_options<\/span>: regular_expressions<\/span>;
      \nsearch_options<\/span>: whole_quran<\/span>;
      \nrun_analyze<\/span>;
      \nstop<\/span>;
      \n}<\/span><\/td>\n<\/tr>\n
      commandNr<\/span>: number;<\/td>\nCalling the commands which defined in commandsDefinition<\/span>[<\/span>1<\/span>]{\u2026} <\/span>
      \ncommandNr<\/span>:<\/span>1<\/span>;<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n
      Comments And Verses <\/span><\/big><\/span><\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      To view single verses or a range of verses we use square bracket [] and type the verse numbers inside:
      \n[1:1 2:1 3:1-7 6:1-19];<\/span><\/span>
      \nTo include comments between verses, we use parenthesis ( ):
      \n(This is verse 1 to 3 of sura 1) [1:1-3] (The rest of sura 1 is the verses 4 to 7) [1:4-7]; <\/span><\/span>
      \nWe can also use HTML tags in comments:
      \n[1:1] (<\/span><\/span><\/p>\n

      A big SALAM <\/span><\/p>\n

      );<\/p>\n

       <\/p>\n

      Use of Parenthesis and Semicolons <\/strong><\/h3>\n

      To write comments it is necessary to set the text between parenthesis as explained in the upper table. Within the parenthesis we are not allowed to use them again or to use Semicolons ( ;<\/span> ). But! some times we need the usage of these 2 signs in our comments which is done easily by including a Backslash ( \\\\<\/span> ) right before the sign:<\/p>\n

      \"\"<\/p>\n

      (<\/span><\/p>\n

      Including \\\\(Paren1sis\\\\) and \\\\(Semicolons\\\\) in our comments<\/p>\n

      )<\/p>\n

       <\/p>\n

      Use of Comments Designer<\/h3>\n

      \"\"<\/p>\n

      The Comments Designer is specially created for designing long comments and send them back to the Editor at the selected point as HTML Code.<\/p>\n

      To start a new Comment in the Designer all we need is to set the cursor in the right place and choose from the menu Edit=>Comments Designer <\/strong>or press Ctrl+H<\/strong><\/p>\n

      If you have a comment and you would like to edit, than set the cursor inside (between the brackets) and press Ctrl+H<\/strong>. In this case oq Editor will select the whole comment by it self and send it to the Designer.<\/p>\n

      when you finish press Alt+S<\/strong> or choose from the menu File=>sendAndClose<\/strong>. The Designer will build the HTML code with your comment between brackets and send back to oqEditor.<\/p>\n

      (This is a test<\/b> comment);<\/span><\/p>\n

      Hint: If you use brackets or semicolons inside your comment than you have to set the backslash before every bracket and semicolon or you\u00b4ll get errors. Example:<\/p>\n

      (This is a \\\\(test\\\\) comment\\\\; for the right syntax);<\/span><\/span><\/p>\n

      If you are working in the Designer mode, the backslash wll be automatically generated in your code, so you don\u00b4t need to do any more changes<\/p><\/blockquote>\n\n\n\n
      Easy Debugger <\/span><\/big><\/span><\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      \"\"<\/p>\n

      To control all of steps of the oq code for the right syntax we click on the green arrow or press F5 <\/strong>to debug it.<\/p>\n

      On the lower part of the editor we can see all steps one after another in a descending way<\/p>\n

      We close the debug window and reset it by clicking on the button “Reset<\/strong>” in the down left side of the editor<\/p><\/blockquote>\n","protected":false},"excerpt":{"rendered":"

      \u0628\u0633\u0645 \u0627\u0644\u0644\u0647 \u0627\u0644\u0631\u062d\u0645\u0646 \u0627\u0644\u0631\u062d\u064a\u0645 OQ-Editor is specially programmed to design oq-code which is used in OpenQuran since version 1.9.10. With oq code users can automate almost every method which is used in OpenQuran and even call hidden methods such as downloading files und playing Mp3 audio files. OQ Editor contains […]<\/p>\n","protected":false},"author":1,"featured_media":1076,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[507],"tags":[512],"class_list":["post-1068","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-our-projects","tag-openquran"],"_links":{"self":[{"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/posts\/1068","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hanif.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1068"}],"version-history":[{"count":3,"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/posts\/1068\/revisions"}],"predecessor-version":[{"id":1078,"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/posts\/1068\/revisions\/1078"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/hanif.de\/index.php?rest_route=\/wp\/v2\/media\/1076"}],"wp:attachment":[{"href":"https:\/\/hanif.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1068"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hanif.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1068"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hanif.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1068"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}