|
add files
|
1 | |
| 2 |
=encoding utf8 |
|
| 3 | ||
| 4 |
=head1 NAME |
|
| 5 | ||
| 6 |
Mojolicious::Guides - Mojolicious guide to the galaxy |
|
| 7 | ||
| 8 |
=head1 DON'T PANIC! |
|
| 9 | ||
| 10 |
We are constantly working on new documentation, follow us on |
|
| 11 |
L<Twitter|http://twitter.com/kraih>, L<GitHub|http://github.com/kraih/mojo> |
|
| 12 |
or join the official IRC channel C<#mojo> on C<irc.perl.org> to get all the |
|
| 13 |
latest updates. |
|
| 14 | ||
| 15 |
=head1 LEARNING PERL |
|
| 16 | ||
| 17 |
If you are new to Perl, we recommend |
|
| 18 |
L<Learn Perl in 2 hours 30 minutes|http://qntm.org/files/perl/perl.html> for a |
|
| 19 |
quick introduction, or the |
|
| 20 |
L<Modern Perl book|http://modernperlbooks.com/books/modern_perl/>, freely |
|
| 21 |
available in many formats. Both are excellent introductions to the language. |
|
| 22 |
For more books and documentation, check out |
|
| 23 |
L<learn.perl.org|http://learn.perl.org/>. |
|
| 24 | ||
| 25 |
=head1 TUTORIAL |
|
| 26 | ||
| 27 |
=over 2 |
|
| 28 | ||
| 29 |
=item L<Mojolicious::Lite> |
|
| 30 | ||
| 31 |
A fast and fun way to get started developing web applications with Mojolicious |
|
| 32 |
is the L<Mojolicious::Lite> tutorial. This micro web framework is only a thin |
|
| 33 |
wrapper around the normal web framework, so almost everything you learn here |
|
| 34 |
also applies to full L<Mojolicious> applications. The simplified notation |
|
| 35 |
introduced in the tutorial is commonly used throughout the guides and is |
|
| 36 |
therefore considered a prerequisite, you should definitely take a look! |
|
| 37 | ||
| 38 |
=back |
|
| 39 | ||
| 40 |
=head1 GUIDES |
|
| 41 | ||
| 42 |
=over 2 |
|
| 43 | ||
| 44 |
=item L<Mojolicious::Guides::Growing> |
|
| 45 | ||
| 46 |
Starting a L<Mojolicious::Lite> prototype from scratch and growing it into a |
|
| 47 |
well structured L<Mojolicious> application. |
|
| 48 | ||
| 49 |
=item L<Mojolicious::Guides::Routing> |
|
| 50 | ||
| 51 |
Simple and fun introduction to the L<Mojolicious> router. |
|
| 52 | ||
| 53 |
=item L<Mojolicious::Guides::Rendering> |
|
| 54 | ||
| 55 |
Generating content with the L<Mojolicious> renderer. |
|
| 56 | ||
| 57 |
=item L<Mojolicious::Guides::Cookbook> |
|
| 58 | ||
| 59 |
Cooking with L<Mojolicious>, recipes for every taste. |
|
| 60 | ||
| 61 |
=item L<Mojolicious::Guides::Contributing> |
|
| 62 | ||
| 63 |
Become a part of the ongoing L<Mojolicious> development. |
|
| 64 | ||
| 65 |
=item L<Mojolicious::Guides::FAQ> |
|
| 66 | ||
| 67 |
Answers to the most frequently asked questions. |
|
| 68 | ||
| 69 |
=back |
|
| 70 | ||
| 71 |
=head1 HIGHLIGHTS |
|
| 72 | ||
| 73 |
L<Mojolicious> and L<Mojolicious::Lite> are the sum of many parts, small |
|
| 74 |
building blocks that can be used independently, these are the most prominent |
|
| 75 |
ones. |
|
| 76 | ||
| 77 |
=over 2 |
|
| 78 | ||
| 79 |
=item L<Mojo::UserAgent> |
|
| 80 | ||
| 81 |
Full featured non-blocking I/O HTTP and WebSocket user agent. |
|
| 82 | ||
| 83 |
=item L<Mojo::DOM> |
|
| 84 | ||
| 85 |
Very fun and minimalistic HTML/XML DOM parser with CSS selector support. |
|
| 86 | ||
| 87 |
=item L<Mojo::JSON> |
|
| 88 | ||
| 89 |
Minimalistic JSON implementation that just works. |
|
| 90 | ||
| 91 |
=item L<Mojo::Server::Daemon> |
|
| 92 | ||
| 93 |
Full featured, highly portable non-blocking I/O HTTP and WebSocket server, |
|
| 94 |
with self-restart support through L<Mojo::Server::Morbo>, perfect for |
|
| 95 |
development and testing. |
|
| 96 | ||
| 97 |
=item L<Mojo::Server::Prefork> |
|
| 98 | ||
| 99 |
Full featured, UNIX optimized, preforking non-blocking I/O HTTP and WebSocket |
|
| 100 |
server with support for zero downtime software upgrades (hot deployment) |
|
| 101 |
through L<Mojo::Server::Hypnotoad>. |
|
| 102 | ||
| 103 |
=item L<Mojo::Server::CGI>, L<Mojo::Server::PSGI> |
|
| 104 | ||
| 105 |
Transparent CGI and L<PSGI> support out of the box. |
|
| 106 | ||
| 107 |
=item L<Mojo::IOLoop> |
|
| 108 | ||
| 109 |
A minimalistic event loop with support for multiple reactor backends. |
|
| 110 | ||
| 111 |
=item L<Mojo::Template> |
|
| 112 | ||
| 113 |
Very Perl-ish and minimalistic template system. |
|
| 114 | ||
| 115 |
=item L<Test::Mojo> |
|
| 116 | ||
| 117 |
Test driven development toolkit for web applications. |
|
| 118 | ||
| 119 |
=item L<ojo> |
|
| 120 | ||
| 121 |
Fun one-liners using everything above. |
|
| 122 | ||
| 123 |
=back |
|
| 124 | ||
| 125 |
=head1 SPIN-OFFS |
|
| 126 | ||
| 127 |
These modules are not part of the L<Mojolicious> distribution, but have been |
|
| 128 |
designed to be used with it and are being developed under the same umbrella. |
|
| 129 | ||
| 130 |
=over 2 |
|
| 131 | ||
| 132 |
=item L<Mango> |
|
| 133 | ||
| 134 |
Pure-Perl non-blocking I/O MongoDB driver. |
|
| 135 | ||
| 136 |
=back |
|
| 137 | ||
| 138 |
=head1 MORE |
|
| 139 | ||
| 140 |
A lot more documentation and examples by many different authors can be found |
|
| 141 |
in the L<Mojolicious wiki|http://github.com/kraih/mojo/wiki>. |
|
| 142 | ||
| 143 |
=head1 SUPPORT |
|
| 144 | ||
| 145 |
If you have any questions the documentation might not yet answer, don't |
|
| 146 |
hesitate to ask on the |
|
| 147 |
L<mailing-list|http://groups.google.com/group/mojolicious> or the official IRC |
|
| 148 |
channel C<#mojo> on C<irc.perl.org>. |
|
| 149 | ||
| 150 |
=cut |