This repository contains official documentation for SciChart.iOS & macOS: High Performance Realtime iOS & macOS Chart Library.

SciChart.iOS & macOS Chart Examples are provided in Swift & Objective-C. If you are looking for other platforms then please see here:

• Android Charts (Java / Kotlin)
• WPF Charts (C# / WPF)
• Xamarin Charts (C#)

Here you can also find Examples and Tutorials used in documentation articles:

• SciChart iOS Native Tutorials
• SciChart iOS Xamarin Tutorials

• Required dependencies
• Project structure
• Build process
• Development process
  • Adding new article/section
  • Alternative way to add article with new subcategory

• Jazzy - CLI tool that generates documentation for Swift or Objective-C. On Mac it can be installed from rubygems: [sudo] gem install jazzy Latest stable version at the moment of writing was v0.14.2.

• SourceKitten - CLI tool for interacting with SourceKit. On mac is installed via Homebrew - brew install sourcekitten

• The main configuration is stored at .jazzy.yaml.
• The homepage is generated from index.md file
• Primary table of content (TOC), that descibes main categories lies in .jazzy.yml
• Documentation articles are stored at sections and guides folders.
• Images used by articles should be stored at scichart-theme/assets/img/** folder
• Style and template overrides for documentation website can be found is at scichart-theme folder

Run one of the following commands from the build/build_docs.sh script:

e.g sh build/build_docs.sh generate-site

1. To build documentation at first we need to prepare library headers to extract API documentation. Those can be extract from SciChart.framework.

2. We also need to resolve common jazzy problem, when your directory structure does not reflect the include/import statements, e.g. you have #import <MyFile/MyFile.h> but the directory containing MyFile.h is called Sources/Headers. Then whatever -I,path pair you pass the compile fails complaining about not finding files.

Since there's no neat solution we are manually create folder filled with headers from SciChart.framework required by umbrella in needed place to run jazzy against. More informatiion about workarounds:

• realm/jazzy#667
• realm/jazzy#1068

Long story short - SciChart.h must be on the same level, that it's headers SciChart/*.h

.jazzy.yaml should contain the following lines:

    framework_root: path_to_headers/
    umbrella_header: path_to_headers/SciChart.h

3. (Optional). You can cache your SourceKit .json to speed up iterative documentation generation. With the SciChart.h and other headers in SciChart/*.h in place, you can run the following:

sourcekitten doc --objc "SciChart.h" -- -x objective-c \
        -isysroot $(xcrun --sdk iphonesimulator --show-sdk-path) \
        -I "./" > api/scichart-sourcekit-api-docs

This will output your API documentation .json in api/scichart-sourcekit-api-docs file. From here you just need to specify where to get prepared the above .json in .jazzy.yaml:

    sourcekitten_sourcefile: api/scichart-sourcekit-api-docs

4. Then to build documentation (assuming you have your .jazzy.yaml in place) you just use

jazzy

This will build documentation and place it in the root directory

1. Create *.md file at sections folder, to create a new section, e.g SciChart iOS v4 SDK User Manual.md.
2. Or create *.md file at guides folder, to create separate article, e.g. SciChart-iOS-v4-SDK-User-Manual/Installation and System Requirements.md.
3. Edit .jazzy.yaml file add new item(s), that has name that is used in tree and path to *.md file:

custom_categories:
  - name: SciChart iOS v4 SDK User Manual
    children:
      - Installation and System Requirements