[Sugar-devel] Help-21 fails to start

[Tony Anderson]

James,

Thanks for getting me on the right track.

unzipp help-activity-master.zip (download from Godiard's github repo)
install sphinx (pippy install python-sphinx).
go to the unzipped help-activity folder:
     cd /home/tony/Downloads/help-activity-master
     make html
using Nautilus (files), open html/index.html in browser.

This works independent of Sugar.

Tony

On 3/7/19 3:02 PM, Tony Anderson wrote:
> Thanks. I'll keep trying to see if I can find a path.
>
> Tony
>
> On 3/7/19 2:47 PM, James Cameron wrote:
>> Yes, as I said, both Sphinx and "make html" are needed before making
>> the bundle.
>>
>> On Thu, Mar 07, 2019 at 02:43:33PM +0800, Tony Anderson wrote:
>>> I am trying to install help-20 (from Godiard's repository). I 
>>> downloaded the
>>> zip and put it in an XO-1.75 in /home/olpc/Documents. I then 
>>> unzipped it and
>>> ran python setup.py dist_xo. I then installed the activity via
>>> sugar-install-bundle. However, it behaves as before.
>>>
>>> I am speculating that what is expected to happen is that the html 
>>> versions
>>> of the documentation are to be created via the make html. I am 
>>> speculating
>>> that this make command depends on an installed python-sphinx 
>>> package. I was
>>> able to install the Sphinx on my Ubuntu laptop by pippy. However, 
>>> pippy does
>>> not appear to be installed on the XO's.
>>>
>>> My next step is to try the make html to see if it generates the html
>>> version.
>>>
>>> Tony
>>>
>>>
>>> On 3/6/19 11:25 AM, James Cameron wrote:
>>>> Thanks for your interest.
>>>>
>>>> There's no Help-21 yet.  Latest is Help-20.
>>>>
>>>> https://github.com/godiard/help-activity is the most recent source
>>>> code, not https://github.com/sugarlabs/help-activity.  The latter is
>>>> an informative fork.
>>>>
>>>> There should be no html/index.html file in the repository, as it is a
>>>> file generated by building.  The repository is not an activity bundle,
>>>> but source code for building an activity bundle.  The instructions to
>>>> build the bundle include
>>>> http://wiki.sugarlabs.org/go/Activities/Help/Contribute#How_to_get_freshest_Help_sources, 
>>>>
>>>> in particular the dependencies such as Sphinx must be installed, then
>>>> use "make html", and the dist_xo target of setup.py
>>>>
>>>> You'll also see that setup.py is quite different to other activities.
>>>>
>>>> I'm yet to make a new release of Help since v20 in 2015, but it is on
>>>> my list to do.  In deploying it as v20.1 on OLPC laptops, I maintain a
>>>> separate branch, and patch the Sugar version to match what is
>>>> installed.
>>>>
>>>> https://github.com/godiard/help-activity/issues has a list of issues.
>>>>
>>>> On Wed, Mar 06, 2019 at 10:41:11AM +0800, Tony Anderson wrote:
>>>>> The version of the Help activity in github.com/sugarlabs has only 
>>>>> an es
>>>>> folder in the html folder. It fails to start when trying to display
>>>>> html/inde.html (not found).
>>>>>
>>>>> Tony
>>>>>
>>>>> _______________________________________________
>>>>> Sugar-devel mailing list
>>>>> Sugar-devel at lists.sugarlabs.org
>>>>> http://lists.sugarlabs.org/listinfo/sugar-devel
>>>
>>> _______________________________________________
>>> Sugar-devel mailing list
>>> Sugar-devel at lists.sugarlabs.org
>>> http://lists.sugarlabs.org/listinfo/sugar-devel
>
>
> _______________________________________________
> Sugar-devel mailing list
> Sugar-devel at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/sugar-devel