Commit Graph

226 Commits

Author SHA1 Message Date
Cam Findlay 1e2737bc5a Refactored EditLink 2014-11-15 11:46:54 +13:00
Will Rossiter 5cbd9c79cd Restore support for multiple versions in the masthead 2014-11-15 11:41:01 +13:00
Uncle Cheese c71a1aaca2 These changes make a number of improvements, mostly typographical, to improve readability and to render properly on small devices.
Universal increase in font size
Use same font as ss.org for consistency
Remove unnecessary visual noise (borders, box shadows, etc)
Use Google PrettyPrint syntax highlighter for improved readability of code sections
Fully responsive, with hamburger menu
Add "section" linking mode to menu items
Add masthead for breadcrumbs, introduction
Improved styles for notice/info/warning messaging
2014-11-07 12:01:07 +13:00
Will Rossiter f169aa65ac Add support for exclude in children list 2014-10-13 21:55:16 +13:00
Will Rossiter cfa32d56e6 FIX: permission check broken 2014-09-28 17:10:55 +13:00
Will Rossiter 6edaebab41 Encode &amps; in api links. 2014-09-28 14:35:58 +13:00
Will Rossiter f706a9d8a2 FIX: API links should be urlencoded() to prevent special characters causing issues 2014-09-27 19:46:39 +12:00
Will Rossiter 508238a7b2 Correct title generation for index files in entity root
Previously would output the language code as the title 'En'. This double checks whether the file is at the root of the entity and if so, it'll use the entity name.
2014-09-27 10:15:52 +12:00
Will Rossiter db2a94b56c Prevent automatic registration running multiple times
Fix up automatic registration details.
2014-09-27 10:13:40 +12:00
Will Rossiter 9cf55c57d7 Ensure manifest is cached between calls. 2014-09-27 10:12:54 +12:00
Will Rossiter d2aa75e72b Hourly task no longer exists 2014-09-27 08:56:47 +12:00
Will Rossiter 2612f221a6 Change DocumentationParser to use GFM for code 2014-09-26 20:15:40 +12:00
Will Rossiter 113e997b09 FIX: Relative paths from index files showing wrong 2014-09-21 11:20:31 +12:00
Will Rossiter ecac89c0c7 FIX: DocumentationFolder titles not being set. 2014-09-21 11:20:01 +12:00
Will Rossiter 8057c9257c FIX Language viewer test. 2014-09-21 11:19:17 +12:00
Will Rossiter 5ab53e65f2 FIX: Add tests and correct behaviour for next/prev 2014-09-21 11:18:36 +12:00
Will Rossiter e9132c446f Add DocumentationEntity::toMap() for assert compability 2014-09-20 13:43:46 +12:00
Will Rossiter aed63c9df5 Fix issue with Language parameter not being set
When the user accesses a page more than three levels deep.
2014-09-20 13:43:22 +12:00
Will Rossiter 52733d6ebf Add support for [CHILDREN] shortcode
This allows you to build up dynamic listing pages much better.
2014-09-19 23:29:22 +12:00
Will Rossiter b489d5120a Fixes for unit tests with the latest manifest 2014-09-15 22:12:31 +12:00
Will Rossiter 1e04aaed28 Fix breadcrumbs 2014-09-07 22:14:10 +12:00
Will Rossiter 314e504903 Show nested sidebar menu 2014-09-07 21:28:21 +12:00
Will Rossiter 31a3b8a744 Add an alphabetical index (Fixes #5) 2014-09-07 20:35:08 +12:00
Will Rossiter 0b91b91e33 Kill DocumentationService in favour of config API.
This continues on the migration to the Manifest. Instead of using calls to a `Service` now all file related lookups are done through the `DocumentationManifest`
2014-09-07 17:09:28 +12:00
Will Rossiter 43b6d42719 Overhaul of module to use DocumentationManifest
This major update changes the behaviour of the docviewer module to use a cached manifest rather than on demand. This allows us to simplify the URL matching and store 'nice' URL configuration rather than altering handleAction().
2014-09-07 11:26:12 +12:00
Will Rossiter e80edc445e Move advanced form out to it's own class
Make page title customizable through the Config system (Fixes #44)
2014-09-06 11:22:05 +12:00
Will Rossiter 2c00a3b20f New theme.
Clean up of existing theme, implementation of a new easier to integrate layout.
2014-09-06 11:13:12 +12:00
Will Rossiter fab0cba8a8 Add bash syntax brush (Fixes #45) 2014-09-06 09:20:05 +12:00
Will Rossiter 1b0a5c519d Use erusev/parsedown as the Markdown parser. (Fixes #31) 2014-07-27 12:39:44 +12:00
Will Rossiter d5d346ace8 Fix incorrect code block generation when previous line contains whitespace (Fixes #39) 2014-07-27 11:26:10 +12:00
Dan Brooks a6dead1fa2 Regex change to support combo of tab & space in md 2014-03-14 17:05:32 +00:00
Sam Minnee b6b753ee4c FIX: Fixed encoding of & in OpenSearchDescription URLs.
Without this fix, the & was then passed to urlencode(), which escaped the ; and make invalid
XML.  This keeps XML out of the source URL (so the & is just a raw & in the code) and relies on
the template engine to escape XML as needed (the .XML on the end of the variables).
2014-02-14 09:38:37 +13:00
Will Rossiter d68e523e72 Workaround search result matching. 2014-01-14 21:16:39 +13:00
Will Rossiter 95b982353b NEW: Add static publisher option 2014-01-14 20:41:59 +13:00
Will Rossiter c8ba3ffd2a Fix 404 page not including requirements. 2014-01-11 16:20:53 +13:00
Trevor 501d4216c8 Fix/support dash in relative links
Currently if you go had something like this: `[Some Link](../)`
and you were in `http://devsite.dev/dev/docs/my_module/en/server-setup/location-specific/`

The parser will resolve the link as: `http://devsite.dev/dev/docs/my_module/en/server-setup/location-`

This is because the regex is only matching *Any word character (letter, number, underscore)*. I've added the dash.
2013-11-05 15:12:26 +11:00
Ingo Schommer b3d4e402a5 Allow absolute paths in DocumentationSearch::$index_location 2013-10-04 10:55:44 +02:00
Ingo Schommer 2d7c1499d7 Merge pull request #30 from Martimiz/meta-sort-20130522
MAJOR: enable the use of custom metadata and page sorting
2013-06-10 00:42:32 -07:00
Ingo Schommer bd186a0a73 BUG Index relative URLs
Avoids clashes between CLI and web modes (e.g. wrongly configured
$_FILE_TO_URL_MAPPING lookups).
2013-05-29 18:17:14 +02:00
martimiz 227289575a MEDIUM: remove metadata from the current page 2013-05-22 21:35:03 +02:00
martimiz 5400ba2afc MAJOR: enable the use of custom metadata and page sorting 2013-05-22 18:35:26 +02:00
Ingo Schommer cdb55f94f8 Create index location if it doesn't exist 2013-05-17 10:27:21 +02:00
Ingo Schommer 6227e1eb68 Allow symlinks in repo locations (don't resolve on image src) 2013-05-15 15:51:27 +02:00
Ingo Schommer 032a49d929 3.1/3.2 compat 2013-03-26 11:16:46 +01:00
Sean Harvey 0350495d20 Fixing DocumentationViewer::handleAction() to work with SS 3.1 2013-02-20 10:05:05 +13:00
Will Rossiter 3b27cd6b2b NEW: Github style code fence blocks. (Fixes #22) 2013-02-19 22:23:22 +13:00
Sean Harvey 9cf85b0c19 If no versions registered for a module, don't show empty versions in template 2013-02-12 13:43:32 +13:00
Will Rossiter 389269936b Merge pull request #21 from Martimiz/search-20130107 2013-02-07 17:53:41 -08:00
Sean Harvey 4a1e5436eb BUG Fixing search not working when no specific versions of docs 2013-01-24 11:16:47 +13:00
Sean Harvey 927e1b0724 Fixing functions called statically to be declared as such 2013-01-23 16:22:27 +13:00
Will Rossiter 73a66da658 Merge pull request #23 from sdiel/patch-1
Update code/controllers/DocumentationViewer.php
2013-01-11 13:53:43 -08:00
Sebastian Diel 5cc766583d Update code/controllers/DocumentationViewer.php
BUGFIX: fixed mechanism to get nested page entities when using upper case chars as the first char of a markdown files name or a folders name
2013-01-11 11:02:49 +01:00
Sebastian Diel 7d5ee2a249 Update code/controllers/DocumentationViewer.php
BUGFIX: fixed false variable name in DocumentationViewer::set_recursive_submenu()
2013-01-11 10:40:59 +01:00
martimiz 9f1f70a065 Enhancement: allow for enabling/disabling advanced search
The advanced searchbox only really functions properly for multiple
entities if they all have similar versions. If not, it will let you
search on entity-version combinations that might not even exist, which
can get confusing..

In such cases optionally disabling it could be a solution, waiting for
a better solution (possibly
2013-01-07 17:26:39 +01:00
martimiz 0bd844e139 Fix: no search results found on documentation homepage
On the homepage there are no searchedEntities nor searchedVersions
defined, so the searchForm creates empty hiddenfields. PerformSeach
creates subqueries for thes empty values resulting in the return of an
'Empty' query object.

Solution: do not create these fields when there are no entities/versions
2013-01-07 16:53:33 +01:00
martimiz 5bf5da4c92 Minor: add whitespace after comma in module/entity summary 2013-01-07 16:44:00 +01:00
martimiz 58d4f242b0 Fix: Search returns no results for auto-registered modules
Automatic registration sets the version to '' (empty). This breaks the
search as Lucene Search will return an Empty query object if a subquery
has an empty key.

Fix: register the modules as 'current' instead of ''. Setting the
version title to 'current' in DocumentViewer->getVersions() is now no
longer necessary.
2013-01-07 16:41:07 +01:00
martimiz 5d9feb3fe5 Fix: Search error on autoregistered entities
Error: [Warning] array_combine() [function.array-combine]: Both
parameters should have at least 1 element

HandleRequest for submitted forms returns before the automatic
registration of modules is performed, so no entities can be found.
Fixed by moving  DocumentationService::load_automatic_registration();
to the top of the function
2013-01-07 16:31:12 +01:00
martimiz 88660f12f5 Fix: Mark DocumentationSearch::get_index_location() as static 2013-01-07 15:16:21 +01:00
Simon Welsh 6df20c1f73 Adds missing brace 2012-11-14 23:06:26 +13:00
Will Rossiter 0eadf2d174 Merge pull request #20 from Martimiz/master-update-121112
Styling 404 and selecting toplevel pages without children
2012-11-12 21:05:55 -08:00
martimiz 3dcf210045 changed getSubmenu to getSubmenuLocation
Because it doen't return the submenu itself, it returns the preferred
location
2012-11-13 18:04:05 +13:00
martimiz 0df804f86c Allow for either nested or separate submenu form template. Include recursive option
Default setting: separate submenu, no recursion.

Setting recursion fetches all children, to allow for JavaScript-powered
submenus (script not included). If recursion is enabled, separate menus
are disabled.
2012-11-13 18:04:05 +13:00
martimiz 27a4f91d70 Fix: missing 'current' linking mode in top-level menu
If there are no children, the LinkingMode was set to 'link' and never
to 'current'
2012-11-12 16:19:44 +01:00
Sam Minnee 67ff61a756 FIX: Fixed E_STRICT error - static function not marked as such. 2012-11-12 11:26:44 +13:00
Will Rossiter 9aaeadd7ff Migrated theme from doc.ss back to the module 2012-11-10 11:12:30 +13:00
martimiz 262b035fb5 FIX: IsFolder -> isFolder
commit 9672f2862c introduced an error in
getter/setter
2012-11-10 09:27:28 +13:00
martimiz 1f6c5deda7 Minor: coding conventions and javascript, also added submenu title 2012-11-10 09:27:28 +13:00
martimiz 7e7b67548e Mark submenu items with children as folders
Add an arrow to submenuitems that have undelying pages
2012-11-10 09:27:27 +13:00
martimiz 027b63ea0b FIX: remove version from the breadcrumb url for the stable version
Same as in the menu links. fixes multiple urls for the same content
2012-11-10 09:27:27 +13:00
martimiz 62dd4e92f7 Relocate breadcrumbs to the top of the document
Remove breadcrumbs from the searchbar to the top of the page content,
and make sure they only display if there is more then the current link.
Wrap the module and version selectors to fill the gap in the searchbar.
2012-11-10 09:27:27 +13:00
Will Rossiter 317dbb1774 Method visibility 2012-11-10 09:27:10 +13:00
Will Rossiter 74b91a1dd1 NEW Yaml highlighting 2012-09-25 19:36:43 +12:00
Will Rossiter 4ffa1c71e6 FIX: prevent notice while doing search request. 2012-09-09 18:05:06 +12:00
Will Rossiter b4dc440650 FIX: function is named getLink() 2012-09-09 17:13:51 +12:00
Will Rossiter 5d7bf64e73 Design tweaks 2012-09-05 21:42:06 +12:00
Will Rossiter 3a9a384ca4 NEW: Add set_edit_link() and getEditLink() to DocumentViewer to allow adding edit links to be displayed on documentation pages 2012-09-03 22:02:42 +12:00
Stig Lindqvist fa646cdbf6 BUGFIX: Deprecation errors and strict warnings breaks the docsviewer 2012-05-18 09:48:57 +12:00
Will Rossiter ae092ebf19 BUGFIX: ensure E_STRICT compatibility with docsviewer and 3.0 handleRequest(). 2012-04-14 18:02:53 +12:00
Will Rossiter dd84574b8d BUGFIX: upgrade module to fit 3.0 api. 2012-04-14 17:00:22 +12:00
Will Rossiter 1e28e8252f MINOR: rename from docviewer to docsviewer 2012-04-08 21:36:16 +12:00
Will Rossiter a87094fb16 BUGFIX: check for valid directory before opening 2012-04-08 21:27:53 +12:00
Will Rossiter 34d46b7a5b MINOR: update references to sapphiredocs to docviewer. ENHANCEMENT: introduce DOCVIEWER_PATH and DOCVIEWER_DIR consts 2012-04-08 21:23:49 +12:00
Will Rossiter 7381733b4c BUGFIX: fixed search index field naming from module to entity to be consistent. BUGFIX: fixed url for opensearch description. ENHANCEMENT: moved author information to meta_data 2011-08-11 17:03:42 +12:00
Will Rossiter a12169c9e0 MINOR: include own syntax highlighting theme for ssdoc. 2011-08-11 13:32:09 +12:00
Will Rossiter 85e5b1b72d FEATURE: added advanced search form to allow searching by module and version 2011-08-04 10:04:53 +12:00
Will Rossiter 0ba6d8d338 Merge branch 'master' of github.com:silverstripe/silverstripe-sapphiredocs 2011-08-02 15:31:38 +12:00
Will Rossiter 56578742f4 MINOR: merging changes from ss2doc back. APICHANGE: renamed DocumentationOpenSearch_Controller to DocumentationOpenSearchController. MINOR: renamed left and right column to more generic content/sidebar columns 2011-08-02 15:30:58 +12:00
Marcus Nyeholt c9f35cebbb BUGFIX: Changed the base URL for the search so it hits the correct action 2011-07-25 14:35:11 +10:00
Marcus Nyeholt 99951426ed BUGFIX: Change the doc folder search to use the correct folder name variable.
BUGFIX: Use the full path to the basefolder when searching for folders; cwd is actually sapphire, so this ends up looking in the wrong path otherwise
2011-07-25 14:34:30 +10:00
Will Rossiter 959cb16534 FEATURE: added automatic notifications about accessing outdated or unreleased versions. (Fixes #6320) 2011-07-08 14:42:52 +12:00
Will Rossiter 96ac20a15c BUGFIX: fixed bug with linking to internal assets. 2011-07-04 16:58:15 +12:00
Will Rossiter cb19549a97 ENHANCEMENT: if viewing site on current version, do not include version in the parsed links 2011-07-04 12:05:22 +12:00
Will Rossiter 762eb2323b APICHANGE: Renamed internal references of modules to entities and related method naming. FEATURE: added entity navigation in header. BUGFIX: fixed version links so that they redirect to the version of the current page rather than home page 2011-07-01 18:49:31 +12:00
Will Rossiter 4830e09bad ENHANCEMENT: moved 404 page out to a separate template and altered DocumentationViewer to throw 404s on pages which do not resolve to anything. Fixes: #6616 2011-07-01 14:37:55 +12:00
Will Rossiter 15244a9934 ENHANCEMENT: rolled out basic versioning support. 2011-07-01 13:19:35 +12:00
Will Rossiter aa0297d52a Cherry picked changes from doc.silverstripe.org. FEATURE: added boost options to promoting or removing listings from the search. ENHANCEMENT: use a breadcrumb trail for search title to provide additional context 2011-04-29 14:41:30 +12:00
Will Rossiter ef5664f777 BUGFIX: fixed encoding of special characters when not in code snippets. 2011-04-05 14:17:25 +12:00
Will Rossiter cfaa08d858 ENHANCEMENT: fixed default homepage template to include links to individual modules rather than blank pages. BUGFIX: fixed doc viewer to not throw 404 error when no module provided 2011-03-12 17:14:37 +13:00
Will Rossiter bbc657acfc MINOR: changed theme to a darker one to help with readability 2011-03-07 09:55:29 +13:00