| 1 | CrossBrowdy
|
| 2 | ============
|
| 3 | by [Joan Alba Maldonado](https://joanalbamaldonado.com/ "Joan Alba Maldonado's home page") (joanalbamaldonadoNO_SPAM_PLEASE AT gmail DOT com, without NO_SPAM_PLEASE)
|
| 4 |
|
| 5 | Your cross-browser brodie!
|
| 6 |
|
| 7 | [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") is a Multimedia JavaScript framework that can be used to create real cross-platform and hybrid game engines, games, emulators, multimedia libraries and apps.
|
| 8 |
|
| 9 | It is compatible with web browsers, desktop and laptop computers, mobile devices (phones, tablets), desktop and handheld video game consoles, TV sets, smart watches, embedded devices and many others.
|
| 10 |
|
| 11 | It is open source and free.
|
| 12 |
|
| 13 | Main web site: [https://crossbrowdy.com/](https://crossbrowdy.com/ "CrossBrowdy web site")
|
| 14 |
|
| 15 |
|
| 16 | # About & FAQ
|
| 17 | Visit the [About & FAQ section](https://crossbrowdy.com/about "About & FAQ") to know more about [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site").
|
| 18 |
|
| 19 |
|
| 20 | # Download
|
| 21 | To include it in your project and start using it, the most common way to download [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") for production is through the [Download section](https://crossbrowdy.com/download "Download CrossBrowdy") from the official web site.
|
| 22 |
|
| 23 | You can also download [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") from [the GitHub repository](https://github.com/jalbam/CrossBrowdy/ "CrossBrowdy's GitHub repository") directly. Just download the whole content of the **[dist/](https://github.com/jalbam/CrossBrowdy/blob/master/dist/)** folder.
|
| 24 |
|
| 25 | Alternatively, from the command line (shell), you can also use one of the following commands to download [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") while you are in your project folder:
|
| 26 |
|
| 27 |
|
| 28 | ## Using **[Yarn](https://yarnpkg.com/en/package/crossbrowdy "CrossBrowdy's Yarn package")**:
|
| 29 | ```
|
| 30 | yarn add crossbrowdy
|
| 31 | ```
|
| 32 |
|
| 33 |
|
| 34 | ## Using **[npm](https://www.npmjs.com/package/crossbrowdy "CrossBrowdy's npm package")**:
|
| 35 | ```
|
| 36 | npm i crossbrowdy
|
| 37 | ```
|
| 38 |
|
| 39 |
|
| 40 | ## Using **pnpm**:
|
| 41 | ```
|
| 42 | pnpm i crossbrowdy
|
| 43 | ```
|
| 44 |
|
| 45 |
|
| 46 | ## Using **Bower**:
|
| 47 | ```
|
| 48 | bower install jalbam/crossbrowdy --save
|
| 49 | ```
|
| 50 |
|
| 51 | **Note**: [Yarn](https://yarnpkg.com/en/package/crossbrowdy "CrossBrowdy's Yarn package"), [npm](https://www.npmjs.com/package/crossbrowdy "CrossBrowdy's npm package"), pnpm and Bower will also download the [API documentation](https://crossbrowdy.com/api/ "CrossBrowdy API documentation").
|
| 52 |
|
| 53 |
|
| 54 | # Hotlinking
|
| 55 | Instead of downloading CrossBrowdy, you can [hotlink](https://en.wikipedia.org/wiki/Inline_linking) it by directly pointing to a version available online. For instance this way you will be pointing to the last version:
|
| 56 | ```html
|
| 57 | <script src="https://crossbrowdy.com/CrossBrowdy/CrossBrowdy.js" type="text/javascript" language="javascript"></script><!-- "type" and "language" parameters for legacy clients. -->
|
| 58 | ```
|
| 59 | You can find a list of some [CDN providers](https://en.wikipedia.org/wiki/Content_delivery_network) in the [Download section](https://crossbrowdy.com/download#cdn_providers "CDN providers for CrossBrowdy") of the official web site. Thanks to them, you will be able to always use the last up-to-date version or even to point to a specific version you may prefer.
|
| 60 |
|
| 61 | Have in mind that including the CrossBrowdy main file from a [CDN provider](https://en.wikipedia.org/wiki/Content_delivery_network) should never be done for production. This [hotlinking method](https://en.wikipedia.org/wiki/Inline_linking) can be useful just for testing purposes. Some features might not work properly using this way and availability cannot be always guaranteed.
|
| 62 |
|
| 63 |
|
| 64 | # Getting started
|
| 65 | Just include the main JavaScript file, which is called _CrossBrowdy.js_, in your HTML file. The recommended place to include this main JavaScript file is inside the head section (inside the [<head> tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/head)) of the document.
|
| 66 |
|
| 67 | ## Here you have a simple example:
|
| 68 | ```html
|
| 69 | <!DOCTYPE html>
|
| 70 | <html>
|
| 71 | <head>
|
| 72 | <meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
| 73 | <title>My first CrossBrowdy project!</title>
|
| 74 | <script src="CrossBrowdy/CrossBrowdy.js" type="text/javascript" language="javascript"></script><!-- "type" and "language" parameters for legacy clients. -->
|
| 75 | <script type="text/javascript" language="javascript">
|
| 76 | <!--
|
| 77 | CB_init(main); //It will call the "main" function when ready.
|
| 78 |
|
| 79 | //This function will be called when CrossBrowdy is ready:
|
| 80 | function main()
|
| 81 | {
|
| 82 | //Now, you can start using CrossBrowdy here...
|
| 83 | CB_console("CrossBrowdy started!");
|
| 84 | }
|
| 85 | // -->
|
| 86 | </script>
|
| 87 | </head>
|
| 88 | <body>
|
| 89 | <!-- The "CB_console" element will be used automatically in the case that the client does not support console: -->
|
| 90 | <div id="CB_console" style="display:none; visibility:hidden; overflow:scroll;">
|
| 91 | <span style="font-weight:bold;">Console:</span><br />
|
| 92 | </div>
|
| 93 | </body>
|
| 94 | </html>
|
| 95 | ```
|
| 96 | Visit the [Getting started topic](https://crossbrowdy.com/basic_tutorial/general/getting_started/ "Getting started with CrossBrowdy") from the [Basic tutorial](https://crossbrowdy.com/guides#basic_tutorial "CrossBrowdy's Basic tutorial") to learn more.
|
| 97 |
|
| 98 |
|
| 99 | # Usage
|
| 100 | Visit the [Guides & Tutorials section](https://crossbrowdy.com/guides "Guides & Tutorials for CrossBrowdy") to get all the information you may need.
|
| 101 |
|
| 102 |
|
| 103 | # Learn
|
| 104 | Check the [Basic tutorial](https://crossbrowdy.com/guides#basic_tutorial "CrossBrowdy's Basic tutorial") to learn how to use it.
|
| 105 |
|
| 106 |
|
| 107 | # Examples
|
| 108 | Check the [Examples section](https://crossbrowdy.com/guides#examples "CrossBrowdy examples") to see some live examples and learn through their code.
|
| 109 |
|
| 110 |
|
| 111 | # API documentation
|
| 112 | For more technical documentation, visit the [API documentation section](https://crossbrowdy.com/api/ "CrossBrowdy API documentation").
|
| 113 |
|
| 114 | There is also a [structure diagram](https://crossbrowdy.com/api/crossbrowdy_structure_diagram.html) that can be useful to get an abstract idea about the logic structure used by [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site").
|
| 115 |
|
| 116 |
|
| 117 | # News
|
| 118 | Visit the [News section](https://crossbrowdy.com/news "CrossBrowdy News") to keep up to date.
|
| 119 |
|
| 120 |
|
| 121 | # Help
|
| 122 | Check ["_I still have a problem, doubt or suggestion. What can I do?_"](https://crossbrowdy.com/about#i_have_a_problem_doubt_or_suggestion_what_can_i_do).
|
| 123 |
|
| 124 |
|
| 125 | # Community & Get Involved
|
| 126 | Visit the [Community & Get Involved section](https://crossbrowdy.com/community "Community & Get Involved") to access the [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") community through different ways and also to get involved and contribute with its development.
|
| 127 |
|
| 128 | Please, before contributing, do not forget to read first the [code of conduct](https://github.com/jalbam/CrossBrowdy/blob/master/CODE_OF_CONDUCT.md) and [contributing](https://github.com/jalbam/CrossBrowdy/blob/master/CONTRIBUTING.md) documents.
|
| 129 |
|
| 130 |
|
| 131 | # Credits
|
| 132 | CrossBrowdy project was created by [Joan Alba Maldonado (aka Juan Alba Maldonado)](https://joanalbamaldonado.com/ "Joan Alba Maldonado's home page").
|
| 133 | It also uses some external libraries and "third-party" code. The name of these libraries and the name of the authors of these libraries and that other code can be found in the source code as well as in the splash screen (if it was no disabled) and in the console when CrossBrowdy is loading. As this information may vary with each version, it is not included here.
|
| 134 |
|
| 135 |
|
| 136 | # License
|
| 137 | The content from the [API documentation](https://crossbrowdy.com/api/ "CrossBrowdy API documentation"), the content from the [official web site](https://crossbrowdy.com/ "CrossBrowdy web site"), including tutorials, examples, etc. created by [Joan Alba Maldonado (aka Juan Alba Maldonado)](https://joanalbamaldonado.com/ "Joan Alba Maldonado's home page") is licensed under a [Creative Commons Attribution 4.0 International license](https://creativecommons.org/licenses/by/4.0/) (SPDX short identifier: "_CC BY 4.0_").
|
| 138 |
|
| 139 | The code written by [Joan Alba Maldonado (aka Juan Alba Maldonado)](https://joanalbamaldonado.com/ "Joan Alba Maldonado's home page"), which genuinely belongs to the [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy project") project, is licensed under the [2-Clause BSD License](https://choosealicense.com/licenses/bsd-2-clause/) (aka "_Simplified BSD License_" or "_FreeBSD License_", SPDX short identifier: "_BSD-2-Clause_").
|
| 140 |
|
| 141 | Apart from that, it is important to have into account that [CrossBrowdy](https://crossbrowdy.com/ "CrossBrowdy web site") uses some external libraries and some code which may have their own license each. It is important to respect each license properly as the responsibility will always lie with you.
|
| 142 |
|
| 143 | See more at ["_What is the CrossBrowdy's copyright and license?_"](https://crossbrowdy.com/about#what_is_the_crossbrowdy_copyright_and_license). |
| \ | No newline at end of file |