Commit | Line | Data |
4d583dd8 |
1 | =head1 NAME |
2 | |
64ccd8a8 |
3 | Catalyst::Manual::Tutorial::Appendices - Catalyst Tutorial - Part 9: Appendices |
4d583dd8 |
4 | |
5 | |
6 | =head1 OVERVIEW |
7 | |
64ccd8a8 |
8 | This is B<Part 9 of 9> of the Catalyst tutorial. |
4d583dd8 |
9 | |
64ccd8a8 |
10 | L<Tutorial Overview|Catalyst::Manual::Tutorial> |
4d583dd8 |
11 | |
12 | =over 4 |
13 | |
14 | =item 1 |
15 | |
16 | L<Introduction|Catalyst::Manual::Tutorial::Intro> |
17 | |
18 | =item 2 |
19 | |
20 | L<Catalyst Basics|Catalyst::Manual::Tutorial::CatalystBasics> |
21 | |
22 | =item 3 |
23 | |
64ccd8a8 |
24 | L<Basic CRUD|Catalyst::Manual::Tutorial_BasicCRUD> |
4d583dd8 |
25 | |
26 | =item 4 |
27 | |
28 | L<Authentication|Catalyst::Manual::Tutorial::Authentication> |
29 | |
30 | =item 5 |
31 | |
32 | L<Authorization|Catalyst::Manual::Tutorial::Authorization> |
33 | |
34 | =item 6 |
35 | |
36 | L<Debugging|Catalyst::Manual::Tutorial::Debugging> |
37 | |
38 | =item 7 |
39 | |
40 | L<Testing|Catalyst::Manual::Tutorial::Testing> |
41 | |
42 | =item 8 |
43 | |
44 | L<AdvancedCRUD|Catalyst::Manual::Tutorial::AdvancedCRUD> |
45 | |
46 | =item 9 |
47 | |
3c098c71 |
48 | B<Appendices> |
4d583dd8 |
49 | |
50 | =back |
51 | |
4d583dd8 |
52 | =head1 DESCRIPTION |
53 | |
64ccd8a8 |
54 | This part of the tutorial provides supporting information relevant to |
55 | the Catalyst tutorial. |
4d583dd8 |
56 | |
4d583dd8 |
57 | =head1 APPENDIX 1: CUT AND PASTE FOR POD-BASED EXAMPLES |
58 | |
64ccd8a8 |
59 | You may notice that Pod indents example code with four spaces. This |
60 | section provides some quick advice to "un-indent" this text in common |
61 | editors. |
4d583dd8 |
62 | |
4d583dd8 |
63 | =head2 "Un-indenting" with Vi/Vim |
64 | |
64ccd8a8 |
65 | When cutting and pasting multi-line text from Pod-based documents, the |
66 | following vi/vim regexs can be helpful to "un-indent" the inserted text |
67 | (do NOT type the quotes, they are only included to show spaces in the |
68 | regex patterns). I<Note that all 3 of the regexs end in 4 spaces>: |
4d583dd8 |
69 | |
70 | =over 4 |
71 | |
72 | =item * |
73 | |
74 | ":0,$s/^ " |
75 | |
64ccd8a8 |
76 | Removes four leading spaces from the entire file (from the first line, |
77 | C<0>, to the last line, C<$>). |
4d583dd8 |
78 | |
79 | =item * |
80 | |
81 | ":.,$s/^ " |
82 | |
64ccd8a8 |
83 | Removes the first four spaces from the line the cursor is on at the time |
84 | the regex command is executed (".") to the last line of the file. |
4d583dd8 |
85 | |
86 | =item * |
87 | |
88 | ":.,44s/^ " |
89 | |
64ccd8a8 |
90 | Removes four leading space from the current line through line 44 |
91 | (obviously adjust the C<44> to the appropriate value in your example). |
4d583dd8 |
92 | |
93 | =back |
94 | |
4d583dd8 |
95 | =head2 "Un-indenting" with Emacs |
96 | |
64ccd8a8 |
97 | B<TODO> |
4d583dd8 |
98 | |
4d583dd8 |
99 | =head1 APPENDIX 2: USING MYSQL AND POSTGRESQL |
100 | |
64ccd8a8 |
101 | The main database used in this tutorial is the very simple yet powerful |
102 | SQLite. This section provides information that can be used to "convert" |
103 | the tutorial to use MySQL and PostgreSQL. However, note that part of |
104 | the beauty of the MVC architecture is that very little database-specific |
105 | code is spread throughout the system (at least when MVC is "done |
106 | right"). Consequently, converting from one database to another is |
107 | relatively painless with most Catalyst applications. In general, you |
108 | just need to adapt the schema definition C<.sql> file you use to |
109 | initialize your database and adjust a few configuration parameters. |
4d583dd8 |
110 | |
64ccd8a8 |
111 | Also note that the purpose of the data definition statements for this |
112 | section are not designed to take maximum advantage of the various |
113 | features in each database for issues such as referential integrity and |
114 | field types/constraints. |
4d583dd8 |
115 | |
4d583dd8 |
116 | =head2 MySQL |
117 | |
64ccd8a8 |
118 | B<TODO> |
4d583dd8 |
119 | |
120 | =head2 PostgreSQL |
121 | |
64ccd8a8 |
122 | B<TODO> |
4d583dd8 |
123 | |