Added a note about permissions in the Quick Tour #4070
Conversation
| Q | A |
|---|---|
| Doc fix? | yes |
| New docs? | no |
| Applies to | 2.3+ |
| Fixed tickets | #4062 |
| Instead of the greeting page, you may see a blank or error page. This is | ||
| caused by a directory permission misconfiguration. There are several possible | ||
| solutions depending on your operating system. Check out them all in the | ||
| :doc:`installation chapter </book/installation.html#book-installation-permissions>` |
There was a problem hiding this comment.
this doesn't work. you have to use the ref role to link to specific pointers: :ref:book-installation-permission``
| @@ -89,6 +89,13 @@ main concepts. Go to the following URL to be greeted by Symfony2 (replace | |||
| .. image:: /images/quick_tour/hello_fabien.png | |||
| :align: center | |||
|
|
|||
| .. note:: | |||
|
|
|||
| Instead of the greeting page, you may see a blank or error page. This is | |||
There was a problem hiding this comment.
I would be more verbose: "[...] a blank page or an error page." I think that's more readable and sounds better.
|
I use :ref:
Can someone help me solving this issue? Thanks! |
|
Ah, @javiereguiluz the pointer As you can see, the pointer is not directly followed by a headline. That means Sphinx cannot automatically generate the text for the reference link, as it normaly takes the headline. So in this case, you have to write the text yourself. For instance: PS: These reference still don't work well with the fixed navbar, see #3974 |
|
Thanks Wouter and Javier - it's a nice note, and I like that it came from real use experience. I will also say, that I really hate the permission problem. It's something that trips up begi 8000 nners immediately (unless they're using the built-in web server) and has various, complex solutions depending on your OS. I don't know if there is an actual solution, but any time I see something so basic being so annoying, it makes me want something better :). Thanks! |
…guiluz) This PR was merged into the 2.3 branch. Discussion ---------- Added a note about permissions in the Quick Tour | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no | Applies to | 2.3+ | Fixed tickets | #4062 Commits ------- 141cf5e Added the missing title for a reference bed2602 Minor rewording and fixed one reference 93b457e Fixed a wrong documentation reference (thanks @wouterj) 646a00c Added a note about permissions in the Quick Tour
Let's create a DX issue and see if we can find a solution :) |
|
@wouterj are you going to open a DX issue about permissions on Symfony repository? |
|
if you want to do it, feel free to do so. I don't have much time... |
|
Got it! symfony/symfony#11563 |