Wiki
Clone wikirst_link_test / Home
Table of Contents
summary
This file is our project's wiki's rootpage, which Bitbucket requires to be named Home. It exists solely to see how/if we can link to/from it to other project resources. For terms used below, see section= definitions in this project's README.
ordinary file in project repo
We want to be able to link to ordinary files in the "main" project repo, , i.e., objects which are not in its
- downloads
- issues
project-absolute style
- a file in the project's top-level folder: /file_in_project_root.txt
- a file in a child of the project's top-level folder: /subdir_level_1/file_in_folder_just_below_project_root.rst
relative style
- a file in the project's top-level folder: ../file_in_project_root.txt
- a file in a child of the project's top-level folder: ../subdir_level_1/file_in_folder_just_below_project_root.rst
currently-working style
Gotta add src and branch, e.g.,
- a file in the project's top-level folder: ../src/HEAD/file_in_project_root.txt
- a file in a child of the project's top-level folder: ../src/HEAD/subdir_level_1/file_in_folder_just_below_project_root.rst
Bitbucket style
These may work from Bitbucket project READMEs viewed from page=Overview (dunno about from the wiki):
- a file in the project's top-level folder: rst_link_test/file_in_project_root.txt
- a file in a child of the project's top-level folder: rst_link_test/subdir_level_1/file_in_folder_just_below_project_root.rst
downloads
We've got downloads! How to reference them?
project-absolute style
- page listing current downloads: /downloads
- a specific download: /downloads/downloadable_1.txt
currently-working style
Issues are project resources (not in the filetree). Nevertheless, empirically, currently:
- page listing current downloads: ../downloads
- a specific download: ../downloads/downloadable_1.txt
Bitbucket style
- page listing current downloads: rst_link_test/downloads
- a specific download: rst_link_test/downloads/downloadable_1.txt
issues
We've got issues! How to reference them?
project-absolute style
- page listing current issues: /issues
- page for creating new issue: /issues/new
- page for specific issue#=1: /issue/1
currently-working style
Issues are project resources (not in the filetree). Nevertheless, empirically, currently:
- page listing current issues: ../issues
- page for creating new issues: ../issues/new
- page for issue#=1: ../issue/1
Bitbucket style
- page listing current issues: rst_link_test/issues
- page for creating new issue: rst_link_test/issues/new
- page for specific issue#=1: rst_link_test/issue/1
wiki pages
How to reference other wikipages? E.g., another wikipage, but in a folder/subdir 1 level down:
project-absolute style
- same folder/subdir:
- with extension: /wiki/another_wikipage_in_top-level_folder.rst
- without extension: /wiki/another_wikipage_in_top-level_folder
- one level down:
- with extension: /wiki/subdir_level_2/wikipage_in_child_folder.rst
- without extension: /wiki/subdir_level_2/wikipage_in_child_folder
wiki-absolute style
- same folder/subdir:
- with extension: /another_wikipage_in_top-level_folder.rst
- without extension: /another_wikipage_in_top-level_folder
- one level down:
- with extension: /subdir_level_2/wikipage_in_child_folder.rst
- without extension: /subdir_level_2/wikipage_in_child_folder
relative style
same folder/subdir:
- path beginning with dot:
- with extension: ./another_wikipage_in_top-level_folder.rst
- without extension: ./another_wikipage_in_top-level_folder
- path=filename:
- with extension: another_wikipage_in_top-level_folder.rst
- without extension: another_wikipage_in_top-level_folder
- path beginning with dot:
one level down:
- with extension: ./subdir_level_2/wikipage_in_child_folder.rst
- without extension: ./subdir_level_2/wikipage_in_child_folder
Bitbucket style
- same folder/subdir:
- path beginning with dot:
- with extension: rst_link_test/wiki/another_wikipage_in_top-level_folder.rst
- without extension: rst_link_test/wiki/another_wikipage_in_top-level_folder
- path=filename:
- with extension: rst_link_test/wiki/another_wikipage_in_top-level_folder.rst
- without extension: rst_link_test/wiki/another_wikipage_in_top-level_folder
- path beginning with dot:
- one level down:
- with extension: rst_link_test/wiki/subdir_level_2/wikipage_in_child_folder.rst
- without extension: rst_link_test/wiki/subdir_level_2/wikipage_in_child_folder
an image
in downloads
project-absolute style
- /downloads/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
currently-working style
- ../downloads/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
Bitbucket style
- rst_link_test/downloads/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
in project repo
project-absolute style
- /images/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
relative style
- ../images/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
why won't this work?
Note that
- This works: ../src/HEAD/subdir_level_1/file_in_folder_just_below_project_root.rst
- In the main project's sources== ../src , ./images and ./subdir_level_1 are peers
- ... but this fails: ../src/HEAD/images/Jen_Sorensen_PandP-poster-ForWeb.png
Why???
- ../src/HEAD/images/Jen_Sorensen_PandP-poster-ForWeb.png
If you see alternate text or a broken link instead of an image, the path attempt failed.
Bitbucket style
- rst_link_test/images/Jen_Sorensen_PandP-poster-ForWeb.png:
If you see alternate text or a broken link instead of an image, the path attempt failed.
Updated