Wiki
Clone wikirst_link_test / another_wikipage_in_top-level_folder
Table of Contents
summary
This file just happens to be in the same folder/subdir as our project's wiki's 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.
arbitrary file in project repo
We want to be able to link to other 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
Bitbucket style
- 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
relative style
These should probably fail, since downloads are project resources (not in the filetree):
- 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
relative style
These should probably fail, since issues are project resources (not in the filetree):
- 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 Home
This file should be able to link to its Home wikipage thusly:
project-absolute style
- with full file name (including extension): /wiki/Home.rst
- without extension: /wiki/Home
relative style
with full file name (including extension):
- path starting with a dot: ./Home.rst
- path=filename: Home.rst
without extension
Bitbucket style
- with full file name (including extension): rst_link_test/wiki/Home.rst
- without extension: rst_link_test/wiki/Home
wiki pages
How to reference other fellow non-Home wikipages? E.g., another wikipage, but in a folder/subdir 1 level down:
project-absolute style
- with extension: /wiki/subdir_level_2/wikipage_in_child_folder.rst
- without extension: /wiki/subdir_level_2/wikipage_in_child_folder
wiki-absolute style
- with extension: /subdir_level_2/wikipage_in_child_folder.rst
- without extension: /subdir_level_2/wikipage_in_child_folder
relative style
- with extension: ./subdir_level_2/wikipage_in_child_folder.rst
- without extension: ./subdir_level_2/wikipage_in_child_folder
Bitbucket style
- 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
Updated