Skip to content

Commit 728b595

Browse files
committed
Fix paragraphs
1 parent ec6e6e6 commit 728b595

File tree

1 file changed

+5
-7
lines changed

1 file changed

+5
-7
lines changed

coredev/troubleshooting.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@ myst:
1111

1212
This chapter describes how to troubleshoot development issues in Plone.
1313

14+
1415
## Buildout issues
1516

1617
Buildout can be frustrating for those unfamiliar with parsing through autistic robot language.
17-
1818
These errors are almost always a quick fix, and a little bit of understanding goes a long way.
1919

2020

@@ -30,15 +30,11 @@ Let's take this one for example:
3030
```
3131

3232
Buildout has simply noticed that the version of buildout required by the file `bootstrap.py` you are trying to run does not match the version of buildout in your Python library.
33-
3433
In the error above, your system has buildout 1.5.1 installed and the `bootstrap.py` file wants to run with 1.5.2.
3534

3635
To fix, you have a couple options.
37-
3836
First, you can force buildout to run with the version you already have installed by invoking the version tag.
39-
4037
This tells your Plone `bootstrap.py` file to play nicely with the version that you already have installed.
41-
4238
In the case of the error pasted above, that would be:
4339

4440
```shell
@@ -70,7 +66,7 @@ Hooray!
7066
`mr.developer` is never unhappy, except when it is.
7167
Although this technically isn't a buildout issue, it happens when running buildout, so I'm putting it under buildout issues.
7268

73-
When working with the dev instance, especially with all the moving back and forth between GitHub and svn, you may have an old copy of a `src` package.
69+
When working with the dev instance, especially with all the moving back and forth between GitHub and Subversion, you may have an old copy of a `src` package.
7470
The error looks like:
7571

7672
```console
@@ -96,10 +92,10 @@ If buildout ends with warning you that some packages could not be downloaded, th
9692
This is bad and could cause all sorts of whack out errors when you start or try to run things because it never actually downloaded the package.
9793

9894
There are two ways to get this error to go away.
95+
9996
The first is to delete all instances of host filtering.
10097
Go through all the files and delete any lines which say `allow-hosts =` and `allow-hosts +=`.
10198
In theory, by restricting which hosts you download from, buildout will go faster.
102-
10399
The point is that they are safely deletable.
104100

105101
The second option is to allow the host that it is pointing to by adding something like this to your `.cfg`:
@@ -161,7 +157,9 @@ Delete {file}`mkzopeinstance.py` from {file}`bin/`, and rerun buildout to correc
161157
### Can't open file '/Startup/run.py'
162158

163159
Two possible fixes.
160+
164161
If you use Python 2.4 by mistake, use 2.6 instead.
162+
165163
Or you may need to make sure you run `bin/buildout …` after `bin/develop …`.
166164
Try removing {file}`parts/*`, {file}`bin/*`, {file}`.installed.cfg`, then re-bootstrap and re-run buildout, develop, buildout.
167165

0 commit comments

Comments
 (0)