-
Notifications
You must be signed in to change notification settings - Fork 94
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add tutorial for symbol and string collection
Signed-off-by: Keshav Priyadarshi <[email protected]>
- Loading branch information
1 parent
58a45cc
commit 449fd0a
Showing
8 changed files
with
94 additions
and
0 deletions.
There are no files selected for viewing
Binary file added
BIN
+202 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-demo-resource.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+28.8 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-resource-link.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+76 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-result-ctags.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+110 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-result-pygments.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+157 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-result-tree-sitter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+74.7 KB
docs/images/tutorial-web-ui-symbol-and-string-collection-result-xgettext.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,93 @@ | ||
.. _tutorial_web_ui_symbol_and_string_collection: | ||
|
||
Symbol and String Collection (Web UI) | ||
===================================== | ||
|
||
In this tutorial we'll introduce the different addon pipeline that can be used for | ||
collecting symbols and strings from codebase resources. | ||
|
||
.. note:: | ||
This tutorial assumes that you have a working installation of ScanCode.io. | ||
If you don't, please refer to the :ref:`installation` page. | ||
|
||
Throughout this tutorial, we will use this resource for symbol and string collection. | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-demo-resource.png | ||
|
||
Ctags Symbols | ||
------------- | ||
|
||
- Open any existing projects containing a few resources. | ||
|
||
- Click on the **"Add pipeline"** button and select the **"collect_symbols"** | ||
pipeline from the dropdown list. | ||
Check the **"Execute pipeline now"** option and validate with the **"Add pipeline"** | ||
button. | ||
|
||
.. warning:: | ||
The ``collect_symbols`` pipeline requires ``universal-ctags``, please refer | ||
to the :ref:`system_dependencies`. | ||
|
||
- Once the pipeline run completes with success, you can reach the **Resources** list view | ||
by clicking the count number under the **"RESOURCES"** header: | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-resource-link.png | ||
|
||
- Click on any code file and go to **Extra** tab, to get the resource symbols. | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-result-ctags.png | ||
|
||
Xgettext Strings | ||
---------------- | ||
|
||
- Open any existing projects containing a few resources. | ||
|
||
- Click on the **"Add pipeline"** button and select the **"collect_source_strings"** | ||
pipeline from the dropdown list. | ||
Check the **"Execute pipeline now"** option and validate with the **"Add pipeline"** | ||
button. | ||
|
||
.. warning:: | ||
The ``collect_source_strings`` pipeline requires ``gettext``, please refer | ||
to the :ref:`system_dependencies`. | ||
|
||
- Once the pipeline run completes with success, you can reach the **Resources** list view | ||
by clicking the count number under the **"RESOURCES"** header: | ||
|
||
- Click on any code file and go to **Extra** tab, to get the resource strings. | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-result-xgettext.png | ||
|
||
Tree-Sitter Symbols and Strings | ||
------------------------------- | ||
|
||
- Open any existing projects containing a few resources. | ||
|
||
- Click on the **"Add pipeline"** button and select the **"collect_tree_sitter_symbols"** | ||
pipeline from the dropdown list. | ||
Check the **"Execute pipeline now"** option and validate with the **"Add pipeline"** | ||
button. | ||
|
||
- Once the pipeline run completes with success, you can reach the **Resources** list view | ||
by clicking the count number under the **"RESOURCES"** header: | ||
|
||
- Click on any code file and go to **Extra** tab, to get the resource symbols and strings. | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-result-tree-sitter.png | ||
|
||
Pygments Symbols and Strings | ||
------------------------------- | ||
|
||
- Open any existing projects containing a few resources. | ||
|
||
- Click on the **"Add pipeline"** button and select the **"collect_pygments_symbols"** | ||
pipeline from the dropdown list. | ||
Check the **"Execute pipeline now"** option and validate with the **"Add pipeline"** | ||
button. | ||
|
||
- Once the pipeline run completes with success, you can reach the **Resources** list view | ||
by clicking the count number under the **"RESOURCES"** header: | ||
|
||
- Click on any code file and go to **Extra** tab, to get the resource symbols and strings. | ||
|
||
.. image:: images/tutorial-web-ui-symbol-and-string-collection-result-pygments.png |