Do say: X-ray!

Free translation tool for radiology departments

Home >> FAQ

Frequently asked questions


General questions


Who is behind 'Do say'?

'Do say' is a privately owned homepage. The project was initiated by Christian Bösche, radiologist at the hospital in Oskarshamn, Sweden. Christian created the concept for 'Do say' and is responsible for design and programming. His friend Tobias Röhr helped organising the project by finding translators, organising recording sessions and much more. A working group at Oskarshamns Radiology department helped develop the phrase list. All translations and recordings were done by enthusiastic volunteers (see Credits for details).

Why are you giving away 'Do say' for free?

Because we want to. 'Do say' has been a non-profit project from the very beginning and is always going to be. This is not about money. It is about helping people. That's why we are giving away it for free.

Can we use 'Do say' at our department?

Of course. As long as you do not intend to sell it or make money with it. 'Do say' is free for all non commercial purposes. See license for details.

What are the terms and conditions for using this service?

Creative Commons Licence This work is licensed under a Creative Commons Attribution - Non Commercial - ShareAlike 4.0 International License.

In other words: 'Do say' is free as long as you do not try to make money with it. It may NOT be used for commercial purposes. You are free to copy and distribute it as long as you stick to this rule. You may also modify it and spread your own version. New projects based on 'Do say' must give appropiate credit and be distributed under the same license as the original.

How is 'Do say' funded?

Costs for hosting of this page are sponsored by the department for Radiology in Oskarshamn, Sweden. Besides that there is no funding to speak of. All persons involved helped free of charge. Nobody received any payment.


Troubleshooting


Why is 'Do say' not working?

Make sure that Javascript and Cookies are enabled. If you are surfing with Safari mobile (iPhone/iPad) the page is not going to work while 'Private browsing' is active.


Translations


Why are there no questions about kidney function, contrast allergi, pacemaker, loose metal parts, etc?

It's all about patient safety. Even if we had translations for these questions we still would not want do CT with iv contrast or MRI without being able to talk to the patient. Any misunderstandings here might have severe consequences for the patient's health. That's why we do not do these examinations without an interpreter on site.


Privacy/security


What information does 'Do say' save?

We use Cookies or the browsers local storage for saving user settings. Cookies are only used if local storage is not available.

A cookie could for example look like this: "2,11,0,2". These are settings for language menu 1 (2 = English), language menu 2 (11 = Arabic), babble function (0 = off) and user language (2 = English). All this information is saved locally on your harddisc and not transmitted anywhere. No other information is saved.


Development


How long did it take to develop 'Do say'?

From the initial idea until we started using a test verison at our department: about a month. Total development time until we finally went online was 6 months.

What language was 'Do say' programmed in?

'Do say' is a webpage. It is written in HTML, Javascript, CSS and PHP.

What tools were used to create 'Do say'?

No layout tools or external code libraries were used. The entire page was written from scratch just using Phase 5, a German Hmtl editor. Graphics were edited with GIMP. Audio files were recorded and edited using Logic Pro or Audacity.


Download version


What's the difference between Online and Download versions?

The download version can be used without internet connection. It is also faster, has slightly better sound-/graphic quality and an editable database.

Why should I download 'Do say'?

If you want to use it offline or if you have a very slow internet connection.

You might also consider using the download version if you are a regular user. The site can create a fair amount of internet traffic which we actually have to pay for. If we exceed our traffic limits, the site will stop working. And nobody wants that, right?

The final reason for downloading is customisation: the database can be edited and adapted to your needs. You could even build your very own version of 'Do say'!

How do I install the download version?

The page comes packed in a ZIP-file. Download. Create a new folder and label it 'Do say' or whatever you want. Unzip the downloaded file and place contents into the new folder. That's it, no further installation is required. Open page by clicking 'x-ray.html'.

When using 'Do say' at your department we recommend placing the folder in a network location that can be accessed by all users. Shortcuts to the page can then be placed on the desktop of all computers.

If you have any problems running the page this is most likely due to cookies or Javascript being blocked. Private browsing may also cause issues in some browsers.


Editing the database


Can I make changes to 'Do say'?

Sure. The entire database can easily be edited. All you have to do is edit text files and copy some files.

What do I need to create my own version of 'Do say'? Is it difficult?

It's actually quite easy. No programming skills are required. All you need is some basic knowledge about text-editing and handling files. Besides that, only a simple text editor and some common sense are required. Using a html-text editor will probably make things a bit easier.

How can I edit the database?

So far there is no detailed documentation. But if you take a close look at the current database you can probably figure out things yourself. The database includes some comments to get you going. And here is some basic information to start with:

All editable files a located in the folder data/js. First of all: While editing the database is easy it is also very easy to break it. Accidentaly deleting a semicolon is enough to make the entire thing crash and burn. So - whatever you do - ALWAYS make safety copies before making any changes to these files! Save and test your changes regularly.

Settings.js: Customizable settings.
Database.js: Phrases & translations.
Show_on_page.js defines how the page displays database entries.
Interface.js: Translations for categories and user interface.

The picture dictionary can be updated by placing PNG graphic-files in the folder data/graphics/dictionary. Label files 1.png, 2.png and so on. You might have to edit the max number of pictures the page tries to load by default under data/js/settings.js.

Audio files have to be in MP3 format, one file per phrase. Label files according to phrase number (1.mp3, 2.mp3, etc) and place them in a folder under data/audio.

Flag graphics are placed in the folder data/graphics/flags.

I edited the database and now the entire page is broken! What happened?

Keep calm. You problably just forgot a semicolon, a quotation mark, a comma or a bracket. Database entries should look something like this:

whatever = ["..."];
or
whatever = ["...", "...", "..."];

If entries are numbered you have to use consecutive numbering - no doubles, no skipping.

If you do not know the translation for an entry, do not skip it. Create an empty entry just with quotation marks (like this: "") instead.

I created my own database but all non-Latin characters are displayed incorrectly. How can I fix this?

database.js has to be saved in Unicode UTF-8 format. Open the database in a text editor. Select 'Save as'. There should be an option which is labeled 'encoding' or something like that. Change to UTF-8 and save.

Will there be better documentation?

If enough people are in need of it, there might be. Let us know.