Mercurial > p > roundup > code
comparison doc/upgrading.txt @ 7793:72a26f3b94db
doc: fix formatting.
Fix formatting:
Change one example quoting info from another doc to blockquote not
highlighed pre block.
use :: to force some examples to be highighted.
Use '.. code-block:: text' to force no highlighting for plain text
example blocks.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sat, 09 Mar 2024 22:17:42 -0500 |
| parents | 79344ea780ea |
| children | 8bdf0484215c |
comparison
equal
deleted
inserted
replaced
| 7792:ed0fce27fd75 | 7793:72a26f3b94db |
|---|---|
| 1157 ``importtables`` method fails for some reason. | 1157 ``importtables`` method fails for some reason. |
| 1158 | 1158 |
| 1159 Another way that should be faster, but is untested is to use mysql | 1159 Another way that should be faster, but is untested is to use mysql |
| 1160 dump to dump the database. | 1160 dump to dump the database. |
| 1161 https://makandracards.com/makandra/595-dumping-and-importing-from-to-mysql-in-an-utf-8-safe-way | 1161 https://makandracards.com/makandra/595-dumping-and-importing-from-to-mysql-in-an-utf-8-safe-way |
| 1162 recommends:: | 1162 recommends: |
| 1163 | 1163 |
| 1164 Note that when your MySQL server is not set to UTF-8 you need to do | 1164 Note that when your MySQL server is not set to UTF-8 you need to do |
| 1165 mysqldump --default-character-set=latin1 (!) to get a correctly | 1165 mysqldump --default-character-set=latin1 (!) to get a correctly |
| 1166 encoded dump. In that case you will also need to remove the SET | 1166 encoded dump. In that case you will also need to remove the SET |
| 1167 NAMES='latin1' comment at the top of the dump, so the target machine | 1167 NAMES='latin1' comment at the top of the dump, so the target machine |
| 1235 processed. | 1235 processed. |
| 1236 | 1236 |
| 1237 If you do not modify the ``user.register.html`` template in your | 1237 If you do not modify the ``user.register.html`` template in your |
| 1238 tracker's html directory, you *must* set this to 0. Otherwise you will | 1238 tracker's html directory, you *must* set this to 0. Otherwise you will |
| 1239 see the error: | 1239 see the error: |
| 1240 | |
| 1241 .. code-block:: text | |
| 1240 | 1242 |
| 1241 Form is corrupted, missing: opaqueregister. | 1243 Form is corrupted, missing: opaqueregister. |
| 1242 | 1244 |
| 1243 If set to 0, the rate limit check is disabled. | 1245 If set to 0, the rate limit check is disabled. |
| 1244 | 1246 |
| 1627 these forms as it is not needed. | 1629 these forms as it is not needed. |
| 1628 | 1630 |
| 1629 Errors and Troubleshooting - AttributeError list object no attribute value | 1631 Errors and Troubleshooting - AttributeError list object no attribute value |
| 1630 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 1632 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 1631 If you get an error: | 1633 If you get an error: |
| 1634 | |
| 1635 .. code-block:: text | |
| 1632 | 1636 |
| 1633 AttributeError: 'list' object has no attribute 'value' | 1637 AttributeError: 'list' object has no attribute 'value' |
| 1634 | 1638 |
| 1635 in handle_csrf, you have more than one @csrf token for the form. This | 1639 in handle_csrf, you have more than one @csrf token for the form. This |
| 1636 usually occurs because the form uses the standard context/submit | 1640 usually occurs because the form uses the standard context/submit |
| 2148 not need it. | 2152 not need it. |
| 2149 | 2153 |
| 2150 Changes to property permissions | 2154 Changes to property permissions |
| 2151 ------------------------------- | 2155 ------------------------------- |
| 2152 | 2156 |
| 2153 If you create a permission: | 2157 If you create a permission:: |
| 2154 | 2158 |
| 2155 db.security.addPermission(name='View', klass='user', | 2159 db.security.addPermission(name='View', klass='user', |
| 2156 properties=['theme'], check=own_record, | 2160 properties=['theme'], check=own_record, |
| 2157 description="User is allowed to view their own theme") | 2161 description="User is allowed to view their own theme") |
| 2158 | 2162 |
| 2175 page when the search is triggered. This is usually correct since the | 2179 page when the search is triggered. This is usually correct since the |
| 2176 user expects to see the results of the query. But now that | 2180 user expects to see the results of the query. But now that |
| 2177 the code properly checks for duplicate search names, the user should | 2181 the code properly checks for duplicate search names, the user should |
| 2178 stay on the search page if there is an error. To add this to your | 2182 stay on the search page if there is an error. To add this to your |
| 2179 existing issue.search.html page, add the following line after the | 2183 existing issue.search.html page, add the following line after the |
| 2180 hidden field @old-queryname: | 2184 hidden field ``@old-queryname``:: |
| 2181 | 2185 |
| 2182 <input type="hidden" name="@template" value="index|search"/> | 2186 <input type="hidden" name="@template" value="index|search"/> |
| 2183 | 2187 |
| 2184 With this addition, the index template is displayed if there is no | 2188 With this addition, the index template is displayed if there is no |
| 2185 error, and the user stays on the search template if there is an error. | 2189 error, and the user stays on the search template if there is an error. |