Elements: It is the detailed documentation for message composition, keyboard creation and keyboard file management.  See the index to access specific topics.  Scroll to the index number.

This document can be selected, copied and pasted to Notes, Pages or other word processors for printing.

​

 As changes are made to the app either from app updates or suggestions from the users, this Elements document will be updated.  Notice will be provided in the 'Update' section of this website.

​

Email suggestions to support@summagram.tech

    

                             

 

SummaGram Index

__________________________  

 #1    Start Up and create 2 keyboards.  

 #2    Voice translation.  

 #3    Keyboard structure.  

 #4   Toggle keyboards.  

 #5    Key groups and navigation keys.  

 #6    Create a training keyboard.  

 #7    Keyboard file storage.  

 #8    COMPOSE.  

 #9    Cut/Copy/Paste, Save and Restore.  

 #10   Text file storage.  

 #11   File Errors  

 #12   File transfers: Keyboards and Text. 

 

 Scroll to find the # paragraph. 

 

 #1  START UP:

 

 This section will show you how to create two keyboards, a main keyboard and an Emoji keyboard.  The first keyboard to create is your default keyboard.  Select your country and the keyboard fills with the keyboard designed by the developer team. Touch a ? key to show the system keyboard. You can select a small keyboard (if large keyboard shows, pinch in to show the small keyboard. Pinch out to show the large keyboard. Most languages show a suggested keyboard, use it or change it. There are three languages, Persian, Slovak and Vietnam with only punctuation, numbers and a space block. The alpha could not be transferred to the app keyboard due to language complexity.  

 If you do not want the suggested country keyboard, use Apple's system country keyboards.  Select system Settings, General, Keyboard, Keyboards, Add New Keyboard and select a language. You can either use the suggested keyboard with your changes or touch the text area and select an Apple keyboard. Press and hold the Globe, a list of keyboards appears, slide to select.  Transfer the system keyboard characters one key at a time but not the editing keys. You can extend your language with multiple keyboards and assign them to toggle keys.  

 IMPORTANT  Pressing the Protect button protects your keyboard from deleting all key characters with the Clear button or pressing a country button. It is unprotected after saving the keyboard. 

 Start entering key values by selecting a ? key and touch the selected keyboard key.  

To save your keyboard  enter a keyboard name in two places, upper right and lower left as an optional reference to appear in Compose. Press Save. 

To see it in COMPOSE, press Test, press Compose to see your creation. Return to CREATE, press Restore. You can make changes, Save, Test, Compose and Restore over and over. 

 To edit your keyboard, enter the file name and press Edit. 

​

 Now create the second keyboard.  There's an Emoji button 😎 for a suggested emoji keyboard as suggested by our team, press it, change the key entries using the system emoji selection or elsewhere. Enter a file name, suggest emo and save it. 

​

 Now assign the two keyboards to toggle buttons. Go to the KEYBOARD FILES view, press KEYBOARDS for an alphabetic list. Enter your first assigned keyboard file name in the EnterFileName Box, press T1 preferable as your main keyboard. If you selected an Emoji keyboard, enter a file name(emo) and press T10 for assignment (you can use any T#).   Go to COMPOSE, press T1 and your main keyboard appears. Press T10 to see your emojis. 

 This is the end of creating two keyboards. 

​

             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 

 Sources for key values can be selected from a hard keyboard if attached, the system large and a small floating soft keyboard and pasting. 

 Touch a ? key, touch a keyboard character to fill the key.  You can put any language or Unicode character value on any key, add or delete them.  Also copy, paste to them.  You can enter multiple characters. Enter 2 characters and you create a prime and secondary (lower/upper) characters. The editing keys cannot be changed or moved. They are fixed code based.

 

 Touch the big text area or a ? key to show the keyboard icon (bottom right). Touch the icon and a pop up keyboard screen appears. Press the globe and slide up for selections of Keyboard Settings, Emojis or selected languages.  You can delete or enter other emojis from any source including the app emoji in the Create country list.  You can also enter phrases on any key.  Enter a file name and save the keyboard. 

 

 There are two system keyboard formats, a large one that fits on the view bottom and a small floating keyboard. If the large keyboard appears and you want the small floating keyboard, pinch in quickly and finger drag its bottom center to anywhere on the screen. Pinch out the smaller one quickly for the larger size. To see the large keyboard, drag the small keyboard to the bottom center to dismiss it.  Press the keyboard icon, bottom right to dismiss the large keyboard. 

 

 #2  Voice translation: 

 

 Place the cursor in the large text area or on a button. Touch the microphone (turns black), keep the area quiet and start talking. Your voice is translated into the text. Touch the microphone to stop translating. 

 Translating does not work during COMPOSE. Optionally, you can translate into the large CREATE text area then copy/paste into the Compose text area.  To dismiss the keyboard, touch the keyboard icon(bottom right). 

 

 #3  Keyboard Structure:

 

 For iPad there are 8 rows of 14 keys or 112 keys:  95 for any unicode values and 17 for edit. Atomic icons keys ⚛ ⚛ ⚛ ⚛ (Not harmful!) are space indicators.  Copy/paste a ⚛ space anywhere. Two ⚛⚛ icons are for lower and upper case typing. 

 

 If you only want punctuation, numbers and spaces press Basic. With Protect, it disallows another language keyboard to populate the keyboard. 

 

 #4  Toggle keyboards: 

 

 Toggle keyboards is a new concept of having 10 different keyboards instantly available for enhanced texting and toggle back and forth.  This solves situations where languages have layers of symbols and characters that overload one keyboard.  Another situation is where multiple phrases, emojis are needed and many symbols in the arts and sciences required for texting.  Once you have created your keyboards you can assign keyboards up to 10 toggle buttons.  Assign them in KEYBOARD FILES view and select them in Compose.  During normal texting, toggle a button , select the characters, phrases, emojis and symbols into the text message. "

  This is a true evolution of texting where you can select up to 10 keyboards instantly. 

 

 You can ID phrases on a key. Preface the phrase with a ~ tilde character followed by any 2 characters. (no emojis)  Example:  ~A01Good Morning. In Compose, press the key and only the message appears as Good Morning. The code recognizes the ~ and eliminates the ID  ~A01.  There are 2 buttons ID-On and ID-Off.  If Id-On is pressed the ID will show in the text box else press the ID Off to not print the ID.  This allows a way to create a list of phrases showing the ID.

 

 #5  Key groups and navigation keys: 

 

 The keyboard has 2 groups of keys,  ?s (place holders) and text edit keys. Enter data into the ? textfields with 1 or more characters, emojis, NO images. The text edit keys are in fixed key locations. You cannot change their icons or positions, they represent editing code. 

 They are: 

 

  X  Deletes one character at a time.

 ⏩  Tab 3 spaces 

 🔒  CapLock allows upper case texting. 

 🔁  Shift to upper case. 

 ↩️  Return to the next line. 

 |x| Remove Text Markers used in cut, copy and paste.

 ✂   Cut 

 ❐   Copy 

 📋  Paste 

 🔼  Scroll up 

 🔽  Scroll down 

 Cursor:   ⇡ back8 ⇣ down8  ⇠ left one position ⇢ right one position. 

 

 All ? (place holder) key text fields are Apple supported Unicode characters including emojis. All textfields are editable including cut/copy/paste. Double tap to select and see edit options. Press and hold to magnify. 

 

 Any 2 characters on a key are lower and upper case as qQ, wW. The upper case is accessed using the shift key or cap lock during COMPOSE. You can use any 2 characters on any key but only 2. The second character is upper case. Punctuation, numbers, alpha keys are doubled, use them in caps lock or shift mode. There are 4 keys that differ, O-0(zero with slash), $-€ ,£-¥, all other keys show as single characters in COMPOSE.  

 

 Try it...Press a ? key and type. You can cut, copy, paste to and from ? keys. Character font and size are fixed. No limit on characters. 

  You can create and identify phrases, formulas etc. to enter on a ? key. A phrase ID is optional, place it in front of the phrase.ie #1. In COMPOSE you will recognize the ID on the key, leave it or delete it from the text. 

 

 Copy/paste long phrases to any ? key. Or type directly on the ? key. No limit on key characters. 

 All ? keys are repetitive and can be pressed and held for acceleration, it starts slow then speeds up. 

 

  System OS Cut/Copy/Paste is available in CREATE text areas and text keys. Double tap the text, position the handles and select the dropdown options. 

 In COMPOSE, optionally use OS screen touch method for cut, copy and paste. Press Text Start button to position the cursor at text start. After cut, copy and paste, move the cursor with the arrow keys to reposition. 

  The app cut, copy, paste method is more precise and easier to use.  The app uses text |(pipe) markers. Place them around the text to cut or copy. The markers remain to show where cut or copy was made for reference. Press |x| to remove the markers. 

 

 Suggest COMPOSE to create written document of your phrases and their IDs. 

 Suggest before your keyboard is ready to save, take a photo of the keyboard for reference in case you delete it or change devices. You can also save the file in the cloud. Use the Apple Files app. 

 

 #6 Create a training keyboard for learning: 

 

 In CREATE press Basic for the basic keyboard to show.  Enter your keyboard name in the box top right, then optionally, enter the same name on the bottom left key(FileName) for reference when composing or editing. The file name can be any mix of characters, upper or lower and special characters can be used. Space characters are not allowed in the file name and are removed.(Less confusion when entering a name for reading, editing and deleting). Enter key values on any ? key. Save the keyboard.  For keyboard backup: Place a | (pipe) character in front of the name and Save as the original backup copy.  The backup files will show at the list bottom. 

 

 You now have the original file, a |filename as the original backup to read into COMPOSE. 

 

 The keyboards will appear in sorted order on the KEYBOARD FILES view, press KEYBOARDS to view. To track versions of the same filename, if needed, add a date at the end of the file name in date format yymmdd, used for sort order.  To replace the original file (if deleted), read the | file name, remove the | and Save it.  

 

 To get a keyboard, go to KEYBOARD FILES, press KEYBOARDS, showing file names, enter a file name, press Read File. Go to COMPOSE and view the keyboard.  To delete a keyboard, press KEYBOARDS  enter a file name from the list and enter it in the file name box. Press DELETE, press KEYBOARDS and it is gone. 

 

 #7 Keyboard storage: 

 

  All keyboard files are stored in the application's Documents directory.  Use the apple Files app to view the document directory. (There must be at least one keyboard file stored before the SummaGram name shows to see them.)  Use the KEYBOARDS FILES view select KEYBOARDS to see the keyboard files.  Touch the file name box to call the system keyboard, use it to enter a file name, select either Read or Delete a file. There is no undo delete, (if error replace with the | backup file.) 

 

 #8 COMPOSE: 

 

 Composing is where you type a text message.  You can enter, copy, paste and edit any data that is in the text area.  The complete text message is stored in the OS pasteboard and updated as you type.  This is for recovery and pasting elsewhere. 

 When saving a file, space characters are not allowed in the file name and are removed.(Less confusion when entering a file name for reading, editing and deleting). 

 Above the text area are the buttons that control the Compose view and editing buttons. They are: 

 

 Save.  The text message is stored in the compDir directory with the name entered. 

 Read.  The named file is read into the text area. 

 FileName.  The file name appears in the FileName box.  It was saved after the last Save. 

 Delete.  The named file is deleted. Important files should be backed up in the cloud. Use the Files app for that. 

 List.  Shows your stored text files.

 XList.  Dismisses the list.

 PasteToStorage.  Select some or all text, Press PasteToStorage. The pasteboard content is stored. 

 InsertStorage.  Paste the saved text anywhere. "

 TextStart.  Moves the cursor to the text begin. 

 Text End.  Moves the cursor to the text end. 

 Restore Text.  After a Compose exit to another view and upon return, press Restore Text. You should also Save the file for added protection. 

 ClearAll.  Clears the complete message area to start another message or if cleared in error, press the Paste button to restore. 

 Type some text, enter a file name (no spaces) in the top left box using an OS keyboard (not the Compose Keyboard), Save the file, press List, see your text files. XList dimisses the list, press Read to see your text. 

 

 These are the compose edit keys. 

 

 X   Deletes one character at a time. 

 ⏩  Tab 3 spaces 

 🔒  CapLock 

 🔁  Shift to upper case. 

 ↩️  Return to the next line. 

 |x| Remove Text Markers

 ✂   Cut 

  ❐  Copy

 📋  Paste 

 🔼  Scroll up 

 🔽  Scroll down. 

 Cursor navigation:  ⇡ up ⇣ down,  ⇠  left one  ⇢   right one. 

 

 #9  Cut, Copy, Paste: 

 

 There are 2 pasteboards(PB), the operating system(OS) PB and the app PB.  The app PB can receive the whole text or part of it that was placed in the OS PB on a cut or copy. The app PB receives text from the OS PB when pressing StorePaste. 

 During texting, the complete message is stored in the OS PB and recovery storage each time any part of the message changes.  If you want a selected portion of the text to store elsewhere, use the StorePaste and InsertPaste buttons. 

 The app uses 2 pipe markers to select text for cut or copy. 

 IMPORTANT: Before you cut, copy or paste, enter a file name and press Save for permanent storage.  This is will help recovery if you accidentley delete or misalign the text. Press Read with the file name to recover. 

 For cut and copy, select the text with 2 |(pipe)markers, one on text left and one on text right. Press the cut or copy button and the text is copied to the OS PB. Then you can paste anywhere within the text screen, to another app or the internet. Continue texting to refresh the OS KB with the whole text. 

 The app method is more precise than OS as the app cut/copy leaves text markers in place at the cut or copy point.  Move the OS cursor with a touch and lose the original cut point. 

 After an app cut or copy, remove the markers using |x| button.  For pasting into the message, move the cursor to an exact point and paste the text either from OS PB or the InsertPaste button. 

 The OS method uses the touch screen with text handles. 

 If using OS touch screen, Save the text with a file name. Press the Text Start button to position the cursor at the message start position.  It is the only cursor safe place to let OS touch screen methods to proceed.  If not positioned at start, the app will fail if a cut or  paste is made.  If failed restart the app and read the saved file. 

 After OS touch is done, move the cursor from the start position to anywhere in the text using the app arrows.  

 The OS pasteboard text can be pasted anywhere, but before exiting Compose to another view, enter a file name and press Save for permanent storage.  Upon return to Compose, press Restore Text to see the original message or press Read after entering a file name. 

 The ClearAll button clears all the text.  Recover the text by pressing Restore Text button. 

 

 To cut text, use 2 | (pipe) characters to mark a start and end point in the text. Press the ✂ to cut, the text disappears leaving the 2 pipes. The text is stored into the OS pasteboard. To undo press Paste, the text returns at the cursor point.  Press |x| to remove the markers. 

 To copy, place the markers at the start and end points. Press the copy button, it puts a text copy to the OS pasteboard. Then paste it somewhere.  If you want to copy all the text, press copy (no markers). Good for messaging, copying to Pages or the internet. 

 To paste into the current text, place the cursor at any point, press the Pasteboard button. 

 

 Selecting data from outside of the app. Use the split screen feature by touching the ... on the screen top. Tap Split view, select an app or internet data, copy and paste the data to SummaGram's cursor pointer. 

 

 Remember, any time you change the text message, the system pasteboard is updated.  Before Compose exit, Save the text file. If you exit Compose and return, the text screen is blank, press Paste to recover your text or Press Restore Text or Read the file. If leaving COMPOSE and make a paste, your original text paste is lost. Press Restore Text or Read the file.  Always save your text file before exiting COMPOSE. 

 

 If not using the keyboard toggle option, you can swap saved keyboards while composing. First, save the text file. Go to KEYBOARD FILES, enter a keyboard name, press READ FILE, PRESS COMPOSE, the keyboard has changed. Press LastFileName for the last saved text message's File Name, Read the file, make changes with the other keyboard. Save the text file. Repeat the process to bring back the last keyboard used or another one or use the toggle buttons. 

 

  Create extra keyboards with characters,  symbols, phrases that cannot fit on the current keyboard.  Especially engineering, various trades, business, teaching and personal use. 

 

 #10  COMPOSE text storage: 

 

 All COMPOSE text file are stored in the Documents sub directory 'composeDir'. Only text files are stored there. If you transfer the file outside of the app documents directory, append .txt to the file name. Many apps need that extension to identify the content. 

 

 For backup and advanced editing, copy paste to Notes or Pages. Pages is a free Apple application to enhance your text creations with fonts, sizes, images or colors.  You can also use the Apple Files app (which you have) and store your file in the cloud. 

 

 #11 File Errors: 

 

 When attempting to read or save a file and nothing happens, either the file is not there or the name was entered incorrectly. Look at the sorted List closely for the actual name. 

 

 #12  File Transfer:

 

 The Apple Files app on your device is an easy method to transfer files. You can transfer keyboard or text files IN or OUT from the SummaGram application Documents directory and the composeDir to other directories like the iCloud, the app Downloads directory, flash drive or email.

 Transfer or receive a file:

 Open the Files app and notice the left column shows the Locations of directories.  

 Press On My Ipad and the SummaGram app name is shown, select it to see the directories with the keyboard files in its document directory and the composeDir for text files. If you finished the exercise, the file name you assigned is shown. 

 The current directories in the Locations list are iCloud Drive and On My iPad. 

 Lets transfer the file you created to the iCloud Drive. Press the Select button on top, select the file name, press the little circle on name left and a check mark appears. Notice on view bottom for options:  Select Move (the file is deleted from its source) or select More for the copy option.  Select Locations, iCloud Drive. iCloud is highlighted and shows its directories. Scroll and select Documents.  Press the screen to paste the keyboard file. The file transfers to iCloud/Documents directory. Select iCloud Drive/documents and the file name appears. If someone sends you a keyboard that you downloaded into the iPad directory downloads, Move (deletes source) or More (copy) it to the SummaGram app document directory or its sub directory composeDir for text files. 

 Imagine sharing your creations with friends. If you are a business, send to your employees. 

 It would be easier to read this if you copy and paste it into an email, Notes or Pages and print it. 

 SummaGram enhances communication texting around the world with personal custom keyboards. 

 

 🌸 THE END 🌸 

​

                                                           

​